Cursor MCP Guide

🚀 MCP（モデルコンテキストプロトコル）と GitHub の統合について

モデルコンテキストプロトコル (MCP) は、AI エージェントが様々なツールやサービスとシームレスに通信できるようにする画期的な標準化プロトコルです。これは、あたかも汎用翻訳機のようなものです。

• MCP なし：各ツールは独自の言語を持っているため、AI エージェントが複数のツールに統合するのは困難です。
• MCP あり：すべてのツールが同じ言語を使用するため、簡単に統合して通信できます。

実際のケース

10 人の専門アドバイザーがいて、それぞれが異なる言語を話しているとしましょう。

• MCP なし：10 種類の異なる翻訳機が必要です。
• MCP あり：すべての人が共通の言語を話すため、協力が容易になります。

この標準化により、AI エージェントは以下のことができます。

• データベースに接続する
• GitHub とやり取りする
• クラウドサービスにアクセスする
• ファイルやドキュメントを管理する
• その他多数！

✨ GitHub MCP の機能

GitHub MCP 統合は、GitHub リポジトリとの強力なやり取り機能を提供します。

📂 リポジトリ管理

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

💻 コード操作

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

🐛 問題管理

• 問題を作成して更新する
• 問題にコメントを追加する
• 問題を検索する
• ラベルと担当者を適用する
• マイルストーンを追跡する

🤝 協力機能

• プロジェクトパネルを管理する
• ディスカッションを処理する
• コメントをレビューする
• リポジトリ設定を管理する
• アクセス権限を制御する

📦 インストールガイド

前提条件：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：コマンドラインでインストールする

# Smithery CLI を使用する
npx @smithery/cli install @smithery-ai/github

方法 2：手動で設定する

1. Cursor の設定を開きます。
   • macOS の場合は ⌘ + Shift + P、Windows の場合は Ctrl + Shift + P を使用します。
   • 「Cursor 設定」を入力します。
   • 「MCP」を選択します。
2. MCP サーバーを追加します。
   • 「新しいグローバル MCP サーバーを追加」をクリックします。
   • 提供された 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. 問題とプルリクエストを処理する
3. コードを検索する
4. ファイルとブランチを管理する
5. チームメンバーと協力する