{
  "markdown": "# GitStandup MCP Server\n\n> Generate daily standup notes from your git commits using AI\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that automatically collects your git commits from multiple repositories and helps AI assistants generate natural, comprehensive standup summaries.\n\n## ✨ Features\n\n- 📦 **Multi-repo support** - Track commits across all your projects\n- 👤 **User-specific** - Only shows your commits (filtered by git user.email)\n- ⏰ **Time-based** - Configurable lookback period (default: last 24 hours)\n- 🎯 **Smart diff analysis** - Includes code changes with intelligent truncation\n- 💾 **Persistent config** - Remembers your repos in `~/.gitstandup/config.json`\n- 🧹 **Clean output** - Skips generated files (lock files, minified code)\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Using npx (no installation needed)\nnpx -y gitstandup-mcp\n\n# Or install globally\nnpm install -g gitstandup-mcp\n```\n\n### Setup with Claude Desktop\n\nAdd to your Claude Desktop config at `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"gitstandup\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gitstandup-mcp\"]\n    }\n  }\n}\n```\n\n### Setup with VS Code (GitHub Copilot)\n\nAdd to your VS Code MCP settings:\n\n```json\n{\n  \"gitstandup\": {\n    \"type\": \"stdio\",\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"gitstandup-mcp\"]\n  }\n}\n```\n\n## 📖 Usage\n\nOnce configured, you can use natural language with your AI assistant:\n\n```\n\"Generate my standup notes\"\n\"What did I work on yesterday?\"\n\"Show my commits from the last 2 days\"\n```\n\n### First Time Setup\n\n1. **Add your repositories:**\n\n   ```\n   \"Add /path/to/my/project to GitStandup\"\n   ```\n\n2. **Generate standup notes:**\n\n   ```\n   \"Generate my standup notes\"\n   ```\n\n3. **The AI will create a summary like:**\n   > Yesterday I:\n   >\n   > - Implemented OAuth authentication flow in the api-server\n   > - Fixed critical bug in payment processing\n   > - Added integration tests for user registration\n\n## 🛠️ Available Tools\n\nThe server exposes four MCP tools that AI assistants can use:\n\n### `generate_standup`\n\nGenerate standup notes from configured repositories.\n\n**Parameters:**\n\n- `hours` (optional): Number of hours to look back (default: 24)\n- `repos` (optional): Array of specific repo paths to use\n\n**Example:**\n\n```typescript\n{\n  \"hours\": 48,  // Last 2 days\n  \"repos\": [\"/path/to/repo1\", \"/path/to/repo2\"]  // Optional\n}\n```\n\n### `add_repos`\n\nAdd repository paths to the configuration.\n\n**Parameters:**\n\n- `paths`: Array of absolute paths to git repositories\n\n**Example:**\n\n```typescript\n{\n  \"paths\": [\"/Users/you/projects/my-app\", \"/Users/you/projects/api\"]\n}\n```\n\n### `list_repos`\n\nList currently configured repositories.\n\n**Returns:** Array of configured repository paths\n\n### `remove_repos`\n\nRemove repository paths from the configuration.\n\n**Parameters:**\n\n- `paths`: Array of repository paths to remove\n\n## 🔧 Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/muba00/gitstandup.git\ncd gitstandup\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Test locally\nnode build/index.js\n```\n\n### Project Structure\n\n```\ngitstandup/\n├── src/\n│   ├── index.ts      # MCP server setup and tool definitions\n│   ├── git.ts        # Git operations and commit collection\n│   └── config.ts     # Configuration management\n├── build/            # Compiled JavaScript (generated)\n└── package.json\n```\n\n## 📝 Configuration\n\nRepository paths are stored in `~/.gitstandup/config.json`:\n\n```json\n{\n  \"repos\": [\"/Users/you/projects/project1\", \"/Users/you/projects/project2\"]\n}\n```\n\nYou can edit this file manually or use the `add_repos` and `remove_repos` tools.\n\n## 📦 Publishing to MCP Registry\n\nThis server is discoverable via the [GitHub MCP Registry](https://github.com/mcp) and [OSS MCP Community Registry](https://github.com/modelcontextprotocol/registry).\n\n### For Maintainers\n\nTo publish a new version:\n\n1. **Update version in both files:**\n\n   ```bash\n   # Update version in package.json and server.json\n   npm version patch  # or minor/major\n   ```\n\n2. **Build and publish to npm:**\n\n   ```bash\n   npm run build\n   npm publish\n   ```\n\n3. **Install mcp-publisher (first time only):**\n\n   ```bash\n   brew install mcp-publisher\n   # OR\n   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/\n   ```\n\n4. **Authenticate (first time only):**\n\n   ```bash\n   mcp-publisher login github\n   ```\n\n5. **Update server.json version to match package.json and publish:**\n   ```bash\n   mcp-publisher publish\n   ```\n\nThe 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.\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to:\n\n- 🐛 Report bugs\n- 💡 Suggest new features\n- 🔧 Submit pull requests\n\nSee [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details.\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details\n\n## 🙏 Acknowledgments\n\nBuilt with:\n\n- [Model Context Protocol SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n- [simple-git](https://github.com/steveukx/git-js)\n- [Zod](https://github.com/colinhacks/zod)\n\n---\n\n**Note:** This tool only reads git commit history and does not modify your repositories.\n",
  "bytes": 5513,
  "sha": "ed0425eb8444b0fdb1e8560593fa55b3bbc48f64e00c6eef430b40030573a960",
  "repo_slug": "muba00/gitstandup",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_muba00_gitstandup_24bddefb/readme"
}