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.