MCP Vercel Github Integration

🚀 GitHub-Vercel MCP サーバー

GitHub リポジトリの自動作成と Vercel テンプレートの自動デプロイを行う MCP サービスです。

🚀 クイックスタート

このサービスは、GitHub リポジトリの自動作成と Vercel テンプレートの自動デプロイを行います。以下の手順に従って、サービスを利用してください。

✨ 主な機能

• 🚀 自動検出：トークンから GitHub ネームスペースを自動的に識別します。
• 🤖 チーム対応：チームレベルでの Vercel 操作をサポートします。
• ⚡ ゼロコンフィグ：ほとんどのケースで追加の設定は不要です。
• 🔒 セキュリティ：認証情報を適切に処理します。

📦 インストール

ローカルインストール

npm install -g @yourpackage/mcp-server-github

MCP 設定

mcp.config.json に以下の内容を追加します。

{
  "mcpServers": {
        "vercel-github": {
          "command": "npx",
          "args": [
            "mcp-vercel-github-integration",
            "-v",
            "<Your Vercel API Key>",
            "-g",
            "<Your Git API Key>"
          ]
    }
  }
}

必要な権限

GitHub Token

repo:       # グローバルリポジトリの制御権限
user:       # ユーザー設定情報の読み取り
read:org    # 組織機能を使用する場合

Vercel Token

• projects:read と projects:write
• teams:read（チームを使用する場合）

💻 使用例

基本的な使用法

mcp execute github --REPO_NAME "my-app" --TEMPLATE_SOURCE "https://github.com/vercel/vercel/tree/main/examples/nextjs"

全パラメータ

API 応答

正常に実行されると、以下のような応答が返されます。

{
  "status": "success",
  "data": {
    "githubRepo": "https://github.com/yourname/repo",
    "vercelProject": "https://repo.vercel.app",
    "projectId": "prj_abc123"
  }
}

エラー処理

一般的なエラー応答は以下の通りです。

{
  "status": "error",
  "error": {
    "code": "GITHUB_AUTH_FAILED",
    "message": "無効な GitHub トークン"
  }
}

🔧 技術詳細

開発

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. 環境を設定します。

   cp .env.example .env
   

4. テストを実行します。

   npm test
   

公開

パッケージをパッケージ化して npm に公開します。

npm publish --access public

📄 ライセンス

MIT