FastMCP Make Report

A Model Context Protocol (MCP) server built with Node.js for generating commit reports from Excel templates.

Features

• Generate Commit Report: Create Excel reports from template with commit information
• Automatically copies report.xlsx template to timestamped output file
• Fills commit data into Excel cells
• Returns the path to the generated report

Installation

npm install

Setup

First, create the Excel template (already included):

node create-template.js

This will generate report.xlsx template with fields for:

• Repository Name
• Commit Hash
• Commit Date
• Commit Comment

Usage

Running the Server

npm start

For development with auto-reload:

npm run dev

Available Tools

gen_commit_report

Generate a commit report from the Excel template with multiple commits.

Parameters:

• commits (array, required): Array of commit objects, each containing:
  • repo_name (string, required): Repository name
  • commit_hash (string, required): Commit hash/ID
  • commit_at (string, required): Commit date/time
  • commit_comment (string, required): Commit message/comment

Example:

{
  "commits": [
    {
      "repo_name": "my-awesome-project",
      "commit_hash": "abc123def456",
      "commit_at": "2026-03-20T10:30:00Z",
      "commit_comment": "Fixed bug in authentication module"
    },
    {
      "repo_name": "my-awesome-project",
      "commit_hash": "xyz789ghi012",
      "commit_at": "2026-03-20T11:45:00Z",
      "commit_comment": "Added new feature for user management"
    }
  ]
}

Output: The tool creates a new Excel file report-{timestamp}.xlsx by cloning the template and filling in all commits in a table format. Returns:

{
  "success": true,
  "message": "Report generated successfully",
  "output_file": "/path/to/report-2026-03-20T10-30-00.xlsx",
  "total_commits": 2,
  "commits": [...]
}

Configuration for MCP Clients

To use this server with an MCP client (like Claude Desktop), add the following to your MCP configuration:

{
  "mcpServers": {
    "fastmcp-make-report": {
      "command": "node",
      "args": ["/path/to/fastmcp-make-report/index.js"]
    }
  }
}

Development

This server uses the Model Context Protocol SDK (@modelcontextprotocol/sdk) to expose tools that can be used by AI assistants and other MCP clients.

Project Structure

• index.js: Main server implementation
• package.json: Node.js dependencies and scripts
• README.md: This file

License

MIT