gitstandup

GitStandup MCP Server

使用 AI 根据你的 git 提交生成每日站会记录

一个 Model Context Protocol (MCP) 服务，可自动收集多个代码仓库中的 git 提交，并帮助 AI 助手生成自然、全面的站会总结。

✨ 功能

• 📦 支持多个代码仓库 - 跟踪所有项目中的提交
• 👤 针对用户筛选 - 仅显示你的提交（按 git user.email 筛选）
• ⏰ 基于时间 - 可配置回溯时间范围（默认：过去 24 小时）
• 🎯 智能差异分析 - 包含代码变更，并进行智能截断
• 💾 持久化配置 - 在 ~/.gitstandup/config.json 中记住你的代码仓库
• 🧹 简洁输出 - 跳过生成的文件（锁文件、压缩代码）

🚀 快速开始

安装

# Using npx (no installation needed)
npx -y gitstandup-mcp

# Or install globally
npm install -g gitstandup-mcp

配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gitstandup": {
      "command": "npx",
      "args": ["-y", "gitstandup-mcp"]
    }
  }
}

配置 VS Code（GitHub Copilot）

将以下内容添加到 VS Code MCP 设置：

{
  "gitstandup": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "gitstandup-mcp"]
  }
}

📖 使用方法

配置完成后，你可以使用自然语言与 AI 助手交互：

"Generate my standup notes"
"What did I work on yesterday?"
"Show my commits from the last 2 days"

首次设置

1. 添加你的代码仓库：

   "Add /path/to/my/project to GitStandup"
   

2. 生成站会记录：

   "Generate my standup notes"
   

3. AI 将生成类似以下的总结：

   昨天我：

   • 在 api-server 中实现了 OAuth 身份验证流程
   • 修复了支付处理中的严重错误
   • 为用户注册添加了集成测试

🛠️ 可用工具

该服务提供四个 MCP 工具，供 AI 助手使用：

generate_standup

根据已配置的代码仓库生成站会记录。

参数：

• hours（可选）：回溯的小时数（默认：24）
• repos（可选）：要使用的特定代码仓库路径数组

示例：

{
  "hours": 48,  // Last 2 days
  "repos": ["/path/to/repo1", "/path/to/repo2"]  // Optional
}

add_repos

将代码仓库路径添加到配置中。

参数：

• paths：Git 代码仓库绝对路径数组

示例：

{
  "paths": ["/Users/you/projects/my-app", "/Users/you/projects/api"]
}

list_repos

列出当前已配置的代码仓库。

返回： 已配置的代码仓库路径数组

remove_repos

从配置中移除代码仓库路径。

参数：

• paths：要移除的代码仓库路径数组

🔧 开发

# 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

项目结构

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

📝 配置

代码仓库路径存储在 ~/.gitstandup/config.json 中：

{
  "repos": ["/Users/you/projects/project1", "/Users/you/projects/project2"]
}

你可以手动编辑此文件，也可以使用 add_repos 和 remove_repos 工具。

📦 发布到 MCP Registry

此服务可通过 GitHub MCP Registry 和 OSS MCP Community Registry 查找。

维护者须知

发布新版本的步骤：

1. 更新两个文件中的版本号：

   # Update version in package.json and server.json
   npm version patch  # or minor/major
   

2. 构建并发布到 npm：

   npm run build
   npm publish
   

3. 安装 mcp-publisher（仅首次需要）：

   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/
   

4. 进行身份验证（仅首次需要）：

   mcp-publisher login github
   

5. 将 server.json 中的版本号更新为与 package.json 一致，然后发布：

   mcp-publisher publish
   

该服务将自动显示在 GitHub MCP Registry 和社区注册表中，方便用户在 VS Code、Claude Desktop 及其他兼容 MCP 的客户端中发现它。

🤝 参与贡献

欢迎贡献！你可以：

• 🐛 报告错误
• 💡 提出新功能建议
• 🔧 提交拉取请求

详情请参阅 CONTRIBUTING.md。

📄 许可证

MIT License - 详情请参阅 LICENSE

🙏 致谢

本项目使用以下项目构建：

• Model Context Protocol SDK
• simple-git
• Zod

---

注意： 此工具只读取 git 提交历史，不会修改你的代码仓库。