Github MCP Server S7g

🚀 GitHub MCP サーバー

GitHub MCP（モデルコンテキストプロトコル）サーバーは、GitHub プラットフォームとの一連のインタラクション機能を提供します。これには、コード検索、問題管理、ユーザー情報の照会、およびワークフロー操作が含まれます。

✨ 主な機能

API メソッド

リポジトリと Pull Request 操作

• Issue または Pull Request の作成/更新: 問題またはプルリクエストを公開または更新します。
• Issue または Pull Request へのコメント: 指定された問題またはプルリクエストにコメントを投稿します。
• Issue または Pull Request の詳細情報の取得: 問題またはプルリクエストの完全な情報（タイトル、説明、状態など）を表示します。
• Issue または Pull Request の履歴の取得: 問題またはプルリクエストの過去の変更履歴を表示します。

コード検索

• コードスニペットの検索: 言語、パス、拡張子などの条件に基づいて、特定のリポジトリ内でコードスニペットを検索します。

ワークフロー操作

• ワークフロー実行のトリガー: GitHub Actions ワークフローの実行をトリガーします。
• ワークフロー実行状態の取得: ワークフローの実行状態と結果を表示します。

ユーザーと組織情報の照会

• ユーザーまたは組織の情報の取得: 特定のユーザーのプロファイル情報または組織の詳細情報を取得します。

検索構文

コード検索

• language:javascript: プログラミング言語で絞り込みます。
• repo:owner/name: 指定されたリポジトリ内で検索します。
• path:app/src: 指定されたパス内で検索します。
• extension:js: ファイル拡張子で絞り込みます。
• 例: q: "import express" language:typescript path:src/

問題検索

• is:issue または is:pr: 種類（問題またはプルリクエスト）で絞り込みます。
• is:open または is:closed: 状態で絞り込みます。
• label:bug: ラベルで絞り込みます。
• author:username: 作者で絞り込みます。
• 例: q: "memory leak" is:issue is:open label:bug

ユーザー検索

• type:user または type:org: アカウントタイプで絞り込みます。
• followers:>1000: フォロワー数で絞り込みます。
• location:London: 地理位置で絞り込みます。
• 例: q: "fullstack developer" location:London followers:>100

詳細な検索構文については、GitHub の検索ドキュメントを参照してください。

📦 インストール

個人アクセストークン

リポジトリへの完全な制御権限を取得するために、GitHub の個人アクセストークンを作成します。

1. Personal access tokens（GitHub 設定 > 開発者設定）にアクセスします。
2. 必要なリポジトリアクセス権限（公開、すべて、または指定）を選択します。
3. repo 権限を持つトークンを作成します（公開リポジトリのみを扱う場合は、public_repo 権限を選択できます）。
4. 生成されたトークンをコピーします。

使用方法

Docker 設定

~/.cursor/mcp_config.json または ~/.windsurf/mcp_config.json に以下の設定を追加します。

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX 設定

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "-e",
        "const mcp = require('mcp'); mcp.start();"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

💻 使用例

基本的な使用法

Issue の作成

{
  "标题": "新功能请求",
  "描述": "请实现新功能...",
  "状态": "已打开"
}

ワークフロー実行のトリガー

{
  "仓库所有者": "username",
  "仓库名称": "repo-name",
  "分支": "main",
  "commit_message": "触发工作流程"
}

🔧 技術詳細

推奨ビルドコマンド

docker build -t mcp/github .

環境変数設定

GitHub MCP サーバーを実行するために必要な環境変数は以下の通りです。

• GITHUB_PERSONAL_ACCESS_TOKEN: GitHub の個人アクセストークンに設定する必要があります。
• PORT (オプション): サービスがリッスンするポートを設定します。デフォルトは 3000 です。

📄 ライセンス

本プロジェクトは MIT ライセンスに従います。詳細は LICENSE ファイルを参照してください。