Gitstandup

🚀 GitStandup MCP 服務器

GitStandup MCP 服務器藉助人工智能，依據你的 Git 提交記錄生成每日站會筆記。它是一個 模型上下文協議 (MCP) 服務器，能自動從多個倉庫收集你的 Git 提交記錄，助力 AI 助手生成自然、全面的站會總結。

✨ 主要特性

• 📦 多倉庫支持：可跟蹤所有項目中的提交記錄。
• 👤 用戶特定：僅顯示你本人的提交記錄（通過 Git 用戶郵箱過濾）。
• ⏰ 基於時間：可配置回顧週期（默認：過去 24 小時）。
• 🎯 智能差異分析：包含代碼變更，並進行智能截斷處理。
• 💾 持久化配置：將你的倉庫信息存儲在 ~/.gitstandup/config.json 中。
• 🧹 輸出簡潔：跳過生成文件（如鎖文件、壓縮代碼）。

🚀 快速開始

安裝

# 使用 npx（無需安裝）
npx -y gitstandup-mcp

# 或者全局安裝
npm install -g gitstandup-mcp

與 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 助手交互：

"生成我的站會筆記"
"我昨天做了什麼？"
"顯示我過去兩天的提交記錄"

首次設置

1. 添加你的倉庫：

"將 /path/to/my/project 添加到 GitStandup"

2. 生成站會筆記：

"生成我的站會筆記"

3. AI 會生成如下總結：

昨天我：

• 在 api-server 中實現了 OAuth 認證流程
• 修復了支付處理中的嚴重 bug
• 為用戶註冊添加了集成測試

🛠️ 可用工具

該服務器提供了四個 MCP 工具，供 AI 助手使用：

generate_standup

根據配置的倉庫生成站會筆記。 參數：

• hours（可選）：回顧的小時數（默認：24）
• repos（可選）：要使用的特定倉庫路徑數組

示例：

{
  "hours": 48,  // 過去兩天
  "repos": ["/path/to/repo1", "/path/to/repo2"]  // 可選
}

add_repos

將倉庫路徑添加到配置中。 參數：

• paths：Git 倉庫的絕對路徑數組

示例：

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

list_repos

列出當前配置的倉庫。 返回值：配置的倉庫路徑數組

remove_repos

從配置中移除倉庫路徑。 參數：

• paths：要移除的倉庫路徑數組

🔧 開發

# 克隆倉庫
git clone https://github.com/muba00/gitstandup.git
cd gitstandup

# 安裝依賴
npm install

# 構建項目
npm run build

# 本地測試
node build/index.js

項目結構

gitstandup/
├── src/
│   ├── index.ts      # MCP 服務器設置和工具定義
│   ├── git.ts        # Git 操作和提交記錄收集
│   └── config.ts     # 配置管理
├── build/            # 編譯後的 JavaScript（自動生成）
└── package.json

📝 配置

倉庫路徑存儲在 ~/.gitstandup/config.json 中：

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

你可以手動編輯此文件，也可以使用 add_repos 和 remove_repos 工具進行操作。

📦 發佈到 MCP 註冊表

該服務器可通過 GitHub MCP 註冊表 和 開源 MCP 社區註冊表 被發現。

維護者操作

要發佈新版本，請按以下步驟操作：

1. 更新兩個文件中的版本號：

# 更新 package.json 和 server.json 中的版本號
npm version patch  # 或 minor/major

2. 構建併發布到 npm：

npm run build
npm publish

3. 安裝 mcp-publisher（僅首次需要）：

brew install mcp-publisher
# 或者
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 註冊表和社區註冊表中，從而在 VS Code、Claude Desktop 和其他 MCP 兼容客戶端中可被發現。

🤝 貢獻

歡迎貢獻代碼！你可以：

• 🐛 報告 bug
• 💡 提出新功能建議
• 🔧 提交拉取請求

詳情請參閱 CONTRIBUTING.md。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

🙏 致謝

本項目基於以下工具構建：

• 模型上下文協議 SDK
• simple-git
• Zod

⚠️ 重要提示

此工具僅讀取 Git 提交歷史記錄，不會修改你的倉庫。