GitHub MCP Server for Cursor IDE

Cursor IDE 向け GitHub MCP サーバー

Cursor IDE から GitHub リポジトリを直接管理できる、強力な GitHub 統合サーバーです。このサーバーは GitHub の API と連携する RESTful API を提供し、リポジトリの作成と管理を簡単にします。

機能

• 新しい GitHub リポジトリの作成
• 既存リポジトリの一覧表示
• セキュアなトークンベースの認証
• レート制限への対策
• 包括的なエラー処理
• 詳細なログ記録
• Webhook のサポート（近日公開）

前提条件

• Node.js（v14 以降）
• npm（v6 以降）
• Personal Access Token を持つ GitHub アカウント
• Cursor IDE

セットアップ

1. このリポジトリをクローンします：

git clone <your-repo-url>
cd github-mcp-server

2. 依存関係をインストールします：

npm install

3. ルートディレクトリに .env ファイルを作成します：

cp .env.example .env

4. .env で環境変数を設定します：

# Server Configuration
PORT=3000
NODE_ENV=development

# GitHub Configuration
GITHUB_TOKEN=your_github_token_here
GITHUB_WEBHOOK_SECRET=your_webhook_secret_here

# Rate Limiting
RATE_LIMIT_WINDOW_MS=900000  # 15 minutes
RATE_LIMIT_MAX_REQUESTS=100

5. GitHub Personal Access Token を生成します：

   • GitHub.com → Settings → Developer Settings → Personal Access Tokens → Tokens (classic) に移動します
   • 「Generate new token」→「Generate new token (classic)」をクリックします
   • トークンにわかりやすい名前を付けます（例：「MCP Server Integration」）
   • 次の権限を選択します：
     • repo（プライベートリポジトリへのフルアクセス）
     • read:org（組織データの読み取り）
     • admin:repo_hook（リポジトリフックへのフルアクセス）
   • 生成されたトークンをコピーし、.env ファイルに貼り付けます

6. サーバーを起動します：

npm run dev

Cursor IDE での使用方法

1. Cursor IDE を開きます
2. MCP サーバーはデフォルトで http://localhost:3000 で実行されます
3. 次のエンドポイントを使用できます：

新しいリポジトリを作成する

curl -X POST http://localhost:3000/api/github/repos \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-new-repo",
    "description": "A new repository created via MCP",
    "private": false,
    "auto_init": true
  }'

自分のリポジトリを一覧表示する

curl http://localhost:3000/api/github/repos

API エンドポイント

GET /health

サーバーの状態を確認するためのヘルスチェックエンドポイントです。

GET /api/github/repos

認証済みユーザーがアクセスできるすべてのリポジトリを一覧表示します。

POST /api/github/repos

新しいリポジトリを作成します。

リクエスト本文：

{
  "name": "repository-name",
  "description": "Repository description",
  "private": false,
  "auto_init": true
}

エラー処理

サーバーには、次のようなケースに対応する包括的なエラー処理が含まれています：

• 無効な GitHub トークン
• レート制限
• 検証エラー
• GitHub API エラー
• サーバーエラー

すべてのエラーはログに記録され、適切な HTTP ステータスコードとともに返されます。

セキュリティ機能

• トークンベースの認証
• レート制限への対策
• 入力検証
• 環境変数の安全な取り扱い
• CORS による保護
• Helmet セキュリティヘッダー

開発

自動再読み込みを有効にして開発モードでサーバーを実行するには：

npm run dev

テストを実行するには：

npm test

ログ記録

ログは次のファイルに保存されます：

• error.log：エラーレベルのログ
• combined.log：すべてのログ

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。