GitHub Project Manager MCP

GitHub プロジェクトマネージャー MCP

GitHub のプロジェクトを管理する MCP（Model Context Protocol）サーバーです。

説明

このプロジェクトは、GitHub プロジェクトの管理操作に特化した MCP サーバーを実装し、次のような一般的なタスクのために GitHub CLI（gh）との連携を提供します。

• issue の管理
• プルリクエストの管理
• 今後の予定：GitHub Projects との連携

Docker での使用

Docker イメージは、リリースごとに GitHub Container Registry に自動で公開されます。

docker run -i --rm -e GH_TOKEN=seu_token ghcr.io/marioalvial/gh-project-manager-mcp

Cursor での MCP の設定

この MCP を Cursor で使用するには、次の設定を .cursor/mcp.json に追加してください。

"gh-project-manager": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GH_TOKEN",
    "ghcr.io/marioalvial/gh-project-manager-mcp"
  ],
  "env": {
    "GH_TOKEN": "seu_token_github"
  }
}

バージョン管理

このプロジェクトは セマンティックバージョニング を使用し、コミットのパターンに基づいて新しいバージョンを自動でリリースします。

統合テスト

このプロジェクトには、実際の GitHub API を使用して GitHub MCP ツールの機能を検証する、包括的な統合テスト一式が含まれています。これらのテストでは、実行中に実際の GitHub リソースを作成・管理し、終了後にクリーンアップします。

統合テストの実行

統合テストを実行するには、適切な権限を持つ GitHub トークンが必要です。

1. 少なくとも次のスコープを持つ GitHub 個人用アクセストークンを作成します：repo、project
2. プロジェクトのルートに、次の内容を含む .env ファイルを作成します。

   GH_INTEGRATION_TEST_TOKEN=your_github_token_here
   GH_INTEGRATION_TEST_OWNER=marioalvial  # or your own username/organization
   GH_INTEGRATION_TEST_REPO=gh-project-manager-mcp  # or your own repository
   GH_INTEGRATION_TEST_PROJECT_ID=your_project_id  # required for project tests
   

3. 統合テストを実行します。

   make function-integration-test
   

テスト方法

統合テストでは、MCP プロトコル層を介さずに実装関数を直接呼び出し、GitHub CLI とのコアなやり取りに焦点を当てます。この方法により、次のことを確認できます。

1. ツールの実装が GitHub CLI コマンドと正しく連携すること
2. リソースの作成とクリーンアップが期待どおりに動作すること
3. トークンの権限不足など、さまざまなシナリオで堅牢なエラー処理が行われること

テストは、さまざまな GitHub API の制限やトークンの権限に関する状況に対応できるよう設計されています。提供されたトークンで利用できない権限を必要とするテストは、自動的にスキップするか、適宜調整します。

注：テストでは実際の GitHub リソース（issue、PR、ブランチなど）を作成・管理するため、本番リポジトリが散らからないよう、テスト用リポジトリを使用してください。

プルリクエストのテスト用の行 — PR テスト向けに更新します。

デモ PR

この変更では、MCP ツールを使用して PR を作成する方法を示します。