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

AI エージェントが GitHub プロジェクトを使用して Agile Sprint ベースのプロジェクトを作成および管理できるようにする MCP (Model Context Protocol) サーバー。

特徴

• GitHub プロジェクト v2 API : GitHub の GraphQL プロジェクト v2 API を完全サポート

• GitHub Issues : GitHub の問題を作成、読み取り、更新する

• GitHub リポジトリ: リポジトリの詳細を取得する

• 型安全性: 最大限の型安全性を実現するために TypeScript で構築されています

Related MCP server: GitHub Enterprise MCP Server

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の GitHub プロジェクト MCP サーバーを自動的にインストールするには:

npx -y @smithery/cli install taylor-lindores-reeves/mcp-github-projects --client claude

使用法

手動インストール

1. このリポジトリをクローンします:

   git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git
   cd mcp-github-projects

2. 依存関係をインストールします:

   bun install

3. GitHub トークンを使用して.envファイルを作成します。

   GITHUB_TOKEN=your_github_personal_access_token
   GITHUB_OWNER=your_github_username

4. サーバーを構築します。

   bun run build

5. MCP クライアントを次の設定で構成します。

{
  "mcpServers": {
    "GitHubProjects": {
      "command": "bun",
      "args": [
        "/path/to/your/directory/mcp-github-projects-main/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "GITHUB_OWNER": "your_github_username_or_org"
      }
    }
  }
}

環境変数

• GITHUB_TOKEN : 適切な権限を持つ GitHub 個人アクセストークン

• GITHUB_OWNER : GitHubのユーザー名または組織名

GitHubトークンの権限

この MCP サーバーには、次の権限を持つ GitHub 個人アクセス トークン (クラシック) が必要です。

• project - プロジェクトの完全な制御

• read:project - プロジェクトの読み取りアクセス

• repo - プライベートリポジトリの完全な制御

• repo:status - コミットステータスにアクセスする

• repo_deployment - デプロイメントステータスにアクセスする

• public_repo - パブリックリポジトリにアクセスする

• repo:invite - リポジトリの招待にアクセスする

• security_events - セキュリティイベントの読み取りと書き込み

発達

コマンド

• ビルド: bun run build

• GraphQL型を生成する: bun run graphql-codegen

プロジェクト構造

このプロジェクトは、GitHub の GraphQL API 用の MCP サーバーであり、Project V2 の操作に重点を置いています。コードベースは、GraphQL を介して GitHub プロジェクトの機能への型付きアクセスを提供します。

利用可能な操作

プロジェクト

• GitHub プロジェクトの作成、読み取り、更新、削除

• プロジェクトのフィールド、項目、ステータスの更新を管理する

• ドラフト問題を実際の問題に変換する

• プロジェクトアイテムのアーカイブとアーカイブ解除

問題

• 問題の詳細を取得する

• プロジェクトに問題を追加する

リポジトリ

• リポジトリ情報を取得する