io.github.muba00/gitstandup
Generate daily standup notes from git commits across multiple repositories with AI summaries.
Ask AI about io.github.muba00/gitstandup
Powered by Claude Β· Grounded in docs
I know everything about io.github.muba00/gitstandup. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
GitStandup MCP Server
Generate daily standup notes from your git commits using AI
A Model Context Protocol (MCP) server that automatically collects your git commits from multiple repositories and helps AI assistants generate natural, comprehensive standup summaries.
β¨ Features
- π¦ Multi-repo support - Track commits across all your projects
- π€ User-specific - Only shows your commits (filtered by git user.email)
- β° Time-based - Configurable lookback period (default: last 24 hours)
- π― Smart diff analysis - Includes code changes with intelligent truncation
- πΎ Persistent config - Remembers your repos in
~/.gitstandup/config.json - π§Ή Clean output - Skips generated files (lock files, minified code)
π Quick Start
Installation
# Using npx (no installation needed)
npx -y gitstandup-mcp
# Or install globally
npm install -g gitstandup-mcp
Setup with Claude Desktop
Add to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"gitstandup": {
"command": "npx",
"args": ["-y", "gitstandup-mcp"]
}
}
}
Setup with VS Code (GitHub Copilot)
Add to your VS Code MCP settings:
{
"gitstandup": {
"type": "stdio",
"command": "npx",
"args": ["-y", "gitstandup-mcp"]
}
}
π Usage
Once configured, you can use natural language with your AI assistant:
"Generate my standup notes"
"What did I work on yesterday?"
"Show my commits from the last 2 days"
First Time Setup
-
Add your repositories:
"Add /path/to/my/project to GitStandup" -
Generate standup notes:
"Generate my standup notes" -
The AI will create a summary like:
Yesterday I:
- Implemented OAuth authentication flow in the api-server
- Fixed critical bug in payment processing
- Added integration tests for user registration
π οΈ Available Tools
The server exposes four MCP tools that AI assistants can use:
generate_standup
Generate standup notes from configured repositories.
Parameters:
hours(optional): Number of hours to look back (default: 24)repos(optional): Array of specific repo paths to use
Example:
{
"hours": 48, // Last 2 days
"repos": ["/path/to/repo1", "/path/to/repo2"] // Optional
}
add_repos
Add repository paths to the configuration.
Parameters:
paths: Array of absolute paths to git repositories
Example:
{
"paths": ["/Users/you/projects/my-app", "/Users/you/projects/api"]
}
list_repos
List currently configured repositories.
Returns: Array of configured repository paths
remove_repos
Remove repository paths from the configuration.
Parameters:
paths: Array of repository paths to remove
π§ Development
# Clone the repository
git clone https://github.com/muba00/gitstandup.git
cd gitstandup
# Install dependencies
npm install
# Build
npm run build
# Test locally
node build/index.js
Project Structure
gitstandup/
βββ src/
β βββ index.ts # MCP server setup and tool definitions
β βββ git.ts # Git operations and commit collection
β βββ config.ts # Configuration management
βββ build/ # Compiled JavaScript (generated)
βββ package.json
π Configuration
Repository paths are stored in ~/.gitstandup/config.json:
{
"repos": ["/Users/you/projects/project1", "/Users/you/projects/project2"]
}
You can edit this file manually or use the add_repos and remove_repos tools.
π¦ Publishing to MCP Registry
This server is discoverable via the GitHub MCP Registry and OSS MCP Community Registry.
For Maintainers
To publish a new version:
-
Update version in both files:
# Update version in package.json and server.json npm version patch # or minor/major -
Build and publish to npm:
npm run build npm publish -
Install mcp-publisher (first time only):
brew install mcp-publisher # OR curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher && sudo mv mcp-publisher /usr/local/bin/ -
Authenticate (first time only):
mcp-publisher login github -
Update server.json version to match package.json and publish:
mcp-publisher publish
The server will automatically appear in both the GitHub MCP Registry and the community registry, making it discoverable in VS Code, Claude Desktop, and other MCP-compatible clients.
π€ Contributing
Contributions are welcome! Feel free to:
- π Report bugs
- π‘ Suggest new features
- π§ Submit pull requests
See CONTRIBUTING.md for details.
π License
MIT License - see LICENSE for details
π Acknowledgments
Built with:
Note: This tool only reads git commit history and does not modify your repositories.
