Gitstandup

🚀 GitStandup MCP Server

AIを使用してGitのコミットから日次のスタンドアップノートを生成します

Model Context Protocol (MCP)サーバーで、複数のリポジトリからGitのコミットを自動的に収集し、AIアシスタントが自然で包括的なスタンドアップの要約を生成するのを支援します。

✨ 主な機能

• 📦 複数リポジトリ対応 - すべてのプロジェクトのコミットを追跡します
• 👤 ユーザー固有 - あなたのコミットのみを表示します（git user.emailでフィルタリング）
• ⏰ 時間ベース - 遡る期間を設定可能です（デフォルト: 過去24時間）
• 🎯 スマートな差分解析 - コードの変更を適切にトリミングして含めます
• 💾 永続的な設定 - ~/.gitstandup/config.jsonにリポジトリを記憶します
• 🧹 クリーンな出力 - 生成されたファイル（ロックファイル、ミニファイされたコード）をスキップします

🚀 クイックスタート

インストール

# npxを使用する場合（インストール不要）
npx -y gitstandup-mcp

# またはグローバルにインストール
npm install -g gitstandup-mcp

Claude Desktopでのセットアップ

~/Library/Application Support/Claude/claude_desktop_config.jsonのClaude Desktopの設定に追加します：

{
  "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アシスタントと自然言語でやり取りできます：

"私のスタンドアップノートを生成して"
"私は昨日何をしたか？"
"過去2日間のコミットを表示して"

初回セットアップ

1. リポジトリを追加する：

   "GitStandupに/path/to/my/projectを追加する"
   

2. スタンドアップノートを生成する：

   "私のスタンドアップノートを生成して"
   

3. AIが次のような要約を作成します：

   昨日私は：

   • api-serverでOAuth認証フローを実装しました
   • 支払い処理の重大なバグを修正しました
   • ユーザー登録の統合テストを追加しました

🔧 利用可能なツール

サーバーは、AIアシスタントが使用できる4つのMCPツールを公開しています：

generate_standup

設定されたリポジトリからスタンドアップノートを生成します。

パラメーター：

• hours (オプション): 遡る時間数（デフォルト: 24）
• repos (オプション): 使用する特定のリポジトリパスの配列

例：

{
  "hours": 48,  // 過去2日間
  "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 RegistryとOSS MCP Community Registryを通じて検索可能です。

メンテナー向け

新しいバージョンを公開するには：

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 Registryとコミュニティレジストリに表示され、VS Code、Claude Desktop、その他のMCP互換クライアントで検索可能になります。

🤝 コントリビューション

コントリビューションは大歓迎です！自由に以下のことを行ってください：

• 🐛 バグを報告する
• 💡 新機能を提案する
• 🔧 プルリクエストを送信する

詳細はCONTRIBUTING.mdを参照してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください

🙏 謝辞

以下を使用して構築されています：

• Model Context Protocol SDK
• simple-git
• Zod

注意: このツールはGitのコミット履歴のみを読み取り、リポジトリを変更することはありません。