Understanding MCP (Model Context Protocol) and GitHub Integration

MCP（Model Context Protocol）と GitHub 連携について

MCP とは？

Model Context Protocol（MCP）は、AI エージェントがさまざまなツールやサービスとシームレスに通信できるようにする、画期的な標準化プロトコルです。万能の翻訳者のようなものだと考えてください。

• MCP がない場合：各ツールはそれぞれ異なる言語を使うため、AI エージェントが複数のツールと連携するのは困難です。
• MCP がある場合：すべてのツールが同じ言語を使うため、簡単に連携して通信できます。

実際の例

それぞれ異なる言語を話す、10 人の専門コンサルタントがいると想像してください。

• MCP がない場合：10 人分の異なる通訳者が必要です
• MCP がある場合：全員が共通の言語を話すため、スムーズに協力できます

この標準化により、AI エージェントは次のことが可能になります。

• データベースに接続する
• GitHub を操作する
• クラウドサービスにアクセスする
• ファイルやドキュメントを管理する
• その他、さまざまな操作を行う

GitHub MCP の機能

GitHub MCP 連携により、GitHub リポジトリを操作するための強力な機能を利用できます。

リポジトリ管理

• 新しいリポジトリを作成する
• 既存のリポジトリをフォークする
• リポジトリをクローンする
• ブランチを管理する
• プルリクエストを作成してマージする

コード操作

• コードを検索する
• ファイルを作成・編集する
• 変更をコミットする
• プルリクエストをレビューする
• コメントやレビューを追加する

Issue 管理

• Issue を作成・更新する
• Issue にコメントを追加する
• Issue を検索する
• ラベルや担当者を設定する
• マイルストーンを追跡する

コラボレーション機能

• プロジェクトボードを管理する
• ディスカッションに対応する
• コメントをレビューする
• リポジトリの設定を管理する
• アクセス権限を管理する

インストールガイド

前提条件：Node.js のセットアップ

1. Node.js のウェブサイトにアクセスします
2. 適切なバージョンをダウンロードします。
   • M1/M2 Mac の場合：macOS ARM64
   • Intel Mac の場合：macOS x64
3. インストーラーを実行し、画面の指示に従います

GitHub MCP のインストール

方法 1：Smithery CLI を使用（推奨）

npx -y @smithery/cli@latest install @smithery-ai/github \
  --client cursor \
  --config '{"githubPersonalAccessToken":"your_token_here"}'

方法 2：手動で設定

1. ~/.cursor/mcp.json を開きます
2. 次の設定を追加します。

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}

Smithery で MCP サーバーを探す

1. Smithery にアクセスします
2. 利用可能な MCP サーバーを閲覧します。
   • カテゴリーで絞り込む
   • 人気順に並べ替える
   • 名前や機能で検索する
3. リストから「GitHub MCP」を選択します
4. インストール手順に従います

Cursor への追加

方法 1：コマンドラインでインストール

# Using Smithery CLI
npx @smithery/cli install @smithery-ai/github

方法 2：手動で設定

1. Cursor の設定を開きます。

   • ⌘ + Shift + P（macOS）または Ctrl + Shift + P（Windows）を使用します
   • 「Cursor Settings」と入力します
   • 「MCP」を選択します

2. MCP サーバーを追加します。

   • 「Add new global MCP server」をクリックします
   • 提供された JSON 構造を使って設定します

方法 3：JSON を直接設定

1. ~/.cursor/mcp.json に移動します
2. サーバー設定を手動で追加します。

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}

GitHub MCP の使用

インストールすると、GitHub MCP を使って次のことができます。

1. リポジトリを作成・管理する
2. Issue やプルリクエストに対応する
3. コードを検索する
4. ファイルやブランチを管理する
5. チームメンバーと協力する