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

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

特徴

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

Related MCP server: GitHub MCP Server Plus

使用法

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

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

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

{ "mcpServers": { "github-projects": { "command": "uvx", "args": [ "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

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

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

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

設定

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

ソースコードからの使用

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

{ "mcpServers": { "github-projects": { "command": "uv", "args": [ "--directory", "/path/to/github-projects-mcp", "run", "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

/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 からアイテムを削除する