Mcp Vercel Github Integration

GitHub-Vercel MCP サーバー

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

特長

• 🚀 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 トークン

repo:       # Full repository control
user:       # Read user profile
read:org    # If using organizations

Vercel トークン

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

使い方

基本的なデプロイ

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

すべてのパラメーター

パラメーター	デフォルト	説明
VERCEL_API_KEY	-	（必須）Vercel API キー
GITHUB_TOKEN	-	（必須）GitHub パーソナルアクセストークン
REPO_NAME	"new-repo"	リポジトリ名
TEMPLATE_SOURCE	Vercel Next.js	テンプレートの Git URL
IS_PRIVATE	true	リポジトリを非公開にする

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": "Invalid GitHub token"
  }
}

開発

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

   npm install
   

3. 環境をセットアップします。

   cp .env.example .env
   

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

   npm test
   

デプロイ

npm パッケージを作成して公開します。

npm publish --access public

ライセンス

MIT