git-mcp-server

MCP server that summarizes daily git activity and generates human-readable worklogs.

Note: the automatic JIRA posting was removed — this project now focuses on producing clear, human-readable daily summaries from git history. You can publish the produced worklog text to JIRA or any other system yourself, or re-add an integration as needed.

Quick start

1. Copy .env.example to .env and adjust any environment variables you want (for example SINCE or DRY_RUN).
2. Install deps: npm install or run npm run install-deps.
3. Start the server (default uses stdio MCP transport): npm start.

Example (dry-run):

DRY_RUN=1 node mcp-server.js

From your MCP client call the worklog/write tool with a ticketId argument.

Package name and publishing

This repository has been prepared for publishing under a scoped package name that you control to avoid npm ownership conflicts:

• Package name: @supreeth_tp/git-mcp-server

You can either publish the package from your account or distribute the generated tarball.

Publish from your account (recommended):

# Ensure you're logged in as the correct npm user
npm whoami

# Publish scoped package as public
npm publish --access public

Install from a tarball (if you prefer to share the built file):

# from the repo root (example tarball name)
npm install ./supreeth_tp-git-mcp-server-1.0.16.tgz

Notes and customization

• The cli/generate-worklog.js script can produce the same dry-run summary without running the MCP transport; point it at a repo with --repo or set GIT_WORK_TREE.
• The time window used for collection is controlled by the SINCE environment variable (default: 1 day ago).
• The summarizer lives in lib/summarize.js and formats commits and file changes into a human-readable bullet list.

If you want the server to automatically post to JIRA again, I can add a pluggable integration that sends the text to JIRA, Slack, or other APIs behind a config flag.