mcp-commit-story

wiggitywhitney/mcp-commit-story

3.3

If you are the rightful owner of mcp-commit-story and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is a specialized server designed to facilitate seamless interaction between AI agents and development workflows, capturing and summarizing real context for enhanced journaling and documentation.

The Model Context Protocol (MCP) server is an innovative solution that integrates with AI agents to enhance the documentation and journaling process for developers. By capturing real-time context from development workflows, the MCP server ensures that journal entries are not only accurate but also rich in detail, reflecting the true nature of the development process. This server operates in the background, automatically generating entries and summaries without interrupting the developer's workflow. It leverages AI to gather insights from commit messages, code changes, and AI chat history, providing a comprehensive view of the project's evolution. The MCP server is particularly valuable for developers who wish to document not just the technical aspects of their work, but also the emotional and strategic decisions that drive their projects forward.

Features

  • Background Generation: Automatically generates journal entries and summaries in the background after each commit, ensuring no workflow interruption.
  • Rich Context Collection: Collects commit messages, code changes, AI chat history, and project documentation to create detailed journal entries.
  • Intelligent Chat Collection: Captures AI conversations between commits to provide complete chronological context for each code change.
  • User Control: Allows users to add manual reflections and capture AI assistant's current knowledge directly into the journal.
  • Mood and Emotion Reflection: Reflects the user's mood and tone based on interactions with the AI agent and commit messages.

Usages

usage with local integration stdio

python
mcp.run(transport='stdio')  # Tools defined via @mcp.tool() decorator

usage with local integration ide plugin

{
  "mcpServers": {
    "commit-story": {
      "command": "python",
      "args": ["commit_story.py"]
    }
  }
}

usage with remote integration sse

python
mcp.run(transport='sse', host="0.0.0.0", port=8000)  # Specify SSE endpoint

usage with remote integration streamable http

yaml
paths:
  /mcp:
    post:
      x-ms-agentic-protocol: mcp-streamable-1.0  # Copilot Studio integration

usage with platform integration github

{"command": "docker", "args": ["run", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"]}

usage with platform integration copilot studio

yaml
paths:
  /mcp:
    post:
      x-ms-agentic-protocol: mcp-streamable-1.0  # Copilot Studio integration