Github Projects V2

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

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーで、GitHub プロジェクト V2 を管理するためのツールを提供します。Claude やその他の MCP クライアントから利用できます。このサーバーは、GitHub GraphQL API を使用して GitHub プロジェクト V2 とやり取りします。

✨ 主な機能

• ユーザーとその組織の GitHub プロジェクト V2 を一覧表示および閲覧する
• プロジェクトのフィールドとプロジェクト内のアイテム（イシュー、プルリクエスト、ドラフトイシュー）を取得する
• イシューを作成し、プロジェクトに追加する
• プロジェクト内で直接ドラフトイシューを作成する
• プロジェクトアイテムのフィールド値を更新する
• プロジェクトからアイテムを削除する

🚀 クイックスタート

このサーバーは、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：ソースコードから実行する

このプロジェクトをソースコードから直接実行するには、以下の手順に従ってください。

環境構築

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 クライアントを次のように設定してください。

{
  "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：プロジェクト内のアイテムを取得する（状態またはカスタム単一選択フィールドでのフィルタリングをサポート）
• create_issue：新しい GitHub イシューを作成する
• add_issue_to_project：既存の GitHub イシューをプロジェクトに追加する
• create_draftIssue：プロジェクト内で直接ドラフトイシューを作成する
• update_field：プロジェクトアイテムのフィールド値を更新する
• remove_item：プロジェクトからアイテムを削除する

⚠️ 注意事項

上記の操作を実行するには、GitHub アカウントに必要な権限があることを確認し、常に GitHub の API 使用ポリシーに従ってください。