GitHub Projects MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides integration with GitHub's Projects v2 API for Agile project management, allowing for managing GitHub Projects, Issues, and Repositories through a Model Context Protocol server.

  • Utilizes GraphQL for interacting with GitHub's Projects v2 API, supporting queries and mutations for projects, fields, items and other GitHub resources.

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

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

特徴

  • GitHub プロジェクト v2 API : GitHub の GraphQL プロジェクト v2 API を完全サポート
  • GitHub Issues : 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 プロジェクトの作成、読み取り、更新、削除
  • プロジェクトのフィールド、項目、ステータスの更新を管理する
  • ドラフト問題を実際の問題に変換する
  • プロジェクトアイテムのアーカイブとアーカイブ解除

問題

  • 問題の詳細を取得する
  • プロジェクトに問題を追加する

リポジトリ

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

ユーザーが自然言語を通じて GitHub の Projects v2 API と対話してアジャイル プロジェクト管理を実行できるようにし、リポジトリの詳細、問題追跡、プロジェクト ボードの管理操作をサポートします。

  1. Features
    1. Installation
      1. Installing via Smithery
    2. Usage
      1. Manual Installation
    3. Environment Variables
      1. GitHub Token Permissions
        1. Development
          1. Commands
        2. Project Structure
          1. Available Operations
            1. Projects
            2. Issues
            3. Repositories
          ID: 86aw338aa5