🔄 MCP + Cursor GitHub Setup

---

title: MCP で Cursor を GitHub 制御に接続

🔄 MCP + Cursor の GitHub セットアップ

MCP サーバーの起動後、Cursor から GitHub を完全に制御できるように設定します。

🛠️ MCP の Cursor セットアップ手順

🧭 1. Cursor エディターを開く

• AI を第一に考えて設計されたコードエディター、Cursor を起動します。
• Settings（左下隅の ⚙️）をクリックします。

🌐 2. MCP セクションに移動する

• Settings で下にスクロールし、MCP (Model Context Protocol) セクションを開きます。
• "Add Server" をクリックします。

🔧 3. MCP サーバーの詳細を入力する

• Name: Local MCP Server
• URL: http://localhost:3333（または server.js で設定したポート）
• Client: ollama またはお好みの LLM エンジンを選択します。
• Auth: ローカルで使用する場合（ファイアウォール内）は空欄にします。トークンベースの認証を使用する場合は、ヘッダーを追加します。

✅ Cursor が MCP サーバーに接続されました！

⚙️ MCP サーバーが起動していることを確認する

ターミナルからサーバーをローカルで実行します。

node server.js

次の出力が表示されます。

✅ MCP server running at http://localhost:3333

🤖 Cursor のプロンプトで GitHub を制御する

MCP に接続したら、Cursor のコマンドパレットを使用します。

⌘ + K / Ctrl + K → 次を入力します。

Create a private GitHub repo named ai-lab
Add README.md to ai-lab repo with initial text
Search repositories about 'android hacking tools'

MCP GitHub プラグイン（@smithery-ai/github）が、サーバー経由で GitHub API 呼び出しを処理します。

✅ MCP 経由で利用できる GitHub ツール

ツール	説明
create_or_update_file	ファイルを作成または更新します
create_repository	新しい GitHub リポジトリを作成します
delete_repository	リポジトリを削除します（サポートされている場合）
get_file_contents	ファイルの内容を読み取ります
search_repositories	GitHub リポジトリを検索します

これらのツールは、Cursor のプロンプトバーから、または次の方法で実行できます。

npx @smithery/cli

🧠 ベストプラクティスのヒント

• mcp.json を安全に保管します（特に GitHub トークン）。
• 本番環境では、シークレットに環境変数を使用します。
• 次のコマンドでサーバー接続をテストします。

curl http://localhost:3333

ログにはツール呼び出しと API レスポンスが表示されるため、デバッグが容易になります。

---

title: "MCP サーバー + GitHub Cursor セットアップガイド" description: "リポジトリの自動化、作成、削除、コミット制御のために、MCP サーバーと Cursor の GitHub 統合を設定する手順を説明します。"

🚀 MCP サーバー + GitHub Cursor 統合

このチュートリアルでは、Cursor を使用して MCP と GitHub を設定し、ターミナルまたは自動化ワークフローからリポジトリを制御する方法を説明します。

📦 前提条件

• Node.js と npm がインストールされていること
• お使いの OS 用の Cursor CLI をダウンロードしていること
• GitHub アカウント
• @modelcontextprotocol/sdk を使用した MCP 対応のエージェント環境

---

🔐 ステップ 1：GitHub Personal Access Token を作成する

1. GitHub Developer Settings に移動します
2. "Fine-grained tokens" → Generate new token をクリックします
3. 次の項目を設定します。
   • Name: just_think
   • Expiration: 2025 年 5 月 18 日（または任意の日付）
   • Permissions:
     • Repositories: 読み取り／書き込みのフルアクセス
     • User: 読み取り／書き込みのフルアクセス
4. 今すぐトークンをコピーします。トークンは二度と表示されません！

github_pat_11A4PP7FQ07lGRHVynbe5e_... (keep it secret!)

---

⚙️ ステップ 2：mcp.json を設定する

{
  "defaultClient": "ollama",
  "ollama": {
    "baseUrl": "http://localhost:11434",
    "model": "llama2"
  },
  "github": {
    "token": "<your_copied_github_token>"
  },
  "agent": {
    "name": "DevOpsAgent",
    "persona": "An automation assistant for GitHub repo management"
  }
}

プロジェクトフォルダーに mcp.json として保存します。

---

💻 ステップ 3：MCP Studio サーバーを実行する

// server.js
import { studio } from '@modelcontextprotocol/sdk/server/studio.js';

studio.run({
  config: './mcp.json',
  port: 3333
});

次に、次を実行します。

node server.js

---

🧠 ステップ 4：Cursor を GitHub に接続する

npx -y @smithery/cli@latest install @smithery-ai/github --client claude --config mcp.json

これにより、GitHub Cursor アダプターがインストールされ、mcp.json のトークンが登録されます。

---

🔧 ステップ 5：Cursor 経由でリポジトリ制御を自動化する

ターミナルを使用して、GitHub リポジトリを作成、削除、または管理します。

✅ リポジトリを作成する

npx @smithery/cli ask "Create a new private repo called test-automation"

❌ リポジトリを削除する

npx @smithery/cli ask "Delete the repo named old-project"

📥 コードをコミットする

npx @smithery/cli ask "Commit all changes to the repo my-app with message 'Init commit'"

---

📚 ユースケース

• 🚀 CI/CD パイプライン – GitHub Actions 経由でワークフローをデプロイします
• 🧠 LLM の自動化 – エージェントがリポジトリのイベントをトリガーできます
• 🛡 セキュアな DevOps – 最小権限のトークンを使用してセキュリティを維持します
• 🧰 開発の完全自動化 – 手動クリックは不要で、すべてターミナルから操作できます

---

📎 リソース

• Cursor GitHub アダプター
• MCP SDK
• Ollama Server

---

これらのファイルを含む、クローンしてすぐに使えるリポジトリ一式が必要な場合は、お気軽にお申し付けください。生成します！