github-projects-mcp

GitHub プロジェクト V2 MCP サーバー

Claude やその他の MCP クライアントを通じて GitHub Projects V2 を管理するためのツールを提供する Model Context Protocol (MCP) サーバーです。このサーバーは、GitHub Projects V2 とのやり取りに GitHub GraphQL API を使用します。

特徴

• ユーザーと組織の GitHub プロジェクト V2 の一覧と表示
• プロジェクトのフィールドと項目（問題、PR、ドラフト問題）を取得する
• 問題を作成してプロジェクトに追加する
• プロジェクト内で直接ドラフト課題を作成する
• プロジェクト項目フィールド値を更新する
• プロジェクトからアイテムを削除する

使用法

このサーバーは、Claude DesktopなどのMCPクライアントで使用できます。MCPクライアントの設定（例： claude_desktop_config.json ）に追加してください。

オプション1: 公開パッケージの使用

以下は、コマンド ランナーとしてuvxを使用する構成例です。

your_pat_here実際の GitHub 個人アクセス トークンに置き換えてください。

オプション2: ソースコードから

ソース コードからプロジェクトを直接実行するには、次の手順に従います。

設定

1. リポジトリをクローンします。
   git clone git@github.com:Arclio/github-projects-mcp.git cd github-projects-mcp
2. 仮想環境を作成してアクティブ化します。
   uv venv source venv/bin/activate
3. 依存関係をインストールします:
   uv pip install -e .
4. GitHub トークンを環境変数として設定します。GitHubパーソナルアクセストークンを作成し、必要な権限を付与します。必要な権限は、 repo 、 project 、 read:orgです。このコマンドを実行した後、トークンを.envファイルに追加します。
   cp .env.example .env
   次に、次の内容を.envファイルに追加します。
   export GITHUB_TOKEN=your_personal_access_token

ソースコードからの使用

ソース コードから使用する場合、MCP クライアントを次のように構成します。

/path/to/github-projects-mcpとyour_pat_hereを実際のリポジトリ パスと GitHub 個人アクセス トークンに置き換えてください。

利用可能なツール

• list_projects : 特定の組織またはユーザーの GitHub プロジェクト V2 を一覧表示する
• get_project_fields : GitHub プロジェクト V2 で利用可能なフィールドを取得する
• get_project_items : GitHub プロジェクト V2 内のアイテムを取得します (状態またはカスタムの単一選択フィールドによるフィルタリングをサポートします)
• create_issue : 新しいGitHubの問題を作成する
• add_issue_to_project : 既存の GitHub の問題をプロジェクト V2 に追加する
• update_project_item_field : プロジェクト項目のフィールド値を更新する
• create_draft_issue : GitHub プロジェクト V2 で直接ドラフト問題を作成する
• delete_project_item : GitHub プロジェクト V2 からアイテムを削除する

詳細な使用方法については、サーバー コード内のツールのドキュメントを参照してください。

発達

プロジェクトは次のように構成されています。

• src/github_projects_mcp/ : メインパッケージディレクトリ
  • server.py : ツール定義を含む MCP サーバーの実装
  • github_client.py : GitHub API とのやり取りのための GraphQL クライアント

貢献するには、次の点に注意してください。

1. すべてのGraphQL操作に適切なエラー処理を追加する
2. すべての関数とパラメータに型注釈を追加する
3. 新しいツールや機能を追加するときにドキュメントを更新する