Github Projects

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

この MCP（モデルコンテキストプロトコル）サーバーは、AI エージェントがアジャイルスプリントベースの GitHub プロジェクトを作成および管理できるようにします。

✨ 主な機能

• GitHub プロジェクト v2 API：GitHub の GraphQL プロジェクト v2 API を完全にサポートします。
• GitHub イシュー：GitHub イシューの作成、読み取り、および更新が可能です。
• GitHub リポジトリ：リポジトリの詳細情報を取得できます。
• 型安全：TypeScript を使用して最大限の型安全を実現しています。

📦 インストール

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 プロジェクトの作成、読み取り、更新、および削除
• プロジェクトフィールド、項目、およびステータス更新の管理
• ドラフトイシューを実際のイシューに変換
• プロジェクト項目のアーカイブとアーカイブ解除

イシュー

• イシューの詳細情報を取得
• イシューをプロジェクトに追加

リポジトリ

• リポジトリ情報を取得