gitstandup

GitStandup MCP サーバー

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

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

✨ 機能

• 📦 複数リポジトリのサポート - すべてのプロジェクトにわたってコミットを追跡します
• 👤 ユーザー固有 - 自分のコミットのみを表示します（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 認証フローを実装
   • 決済処理の重大なバグを修正
   • ユーザー登録の統合テストを追加

🛠️ 利用可能なツール

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

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 をご覧ください。

🙏 謝辞

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

• Model Context Protocol SDK
• simple-git
• Zod

---

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