Vercel MCP Server 🚀

Vercel MCP サーバー 🚀

🔥 Cursor の Composer と Codeium の Cascade の両方から Vercel のデプロイを完全に管理できる、強力な Model Context Protocol（MCP）サーバーです。このツールは、デプロイ、ドメイン、環境変数などを包括的に管理する機能を備え、プロジェクト管理をスムーズにします。

📚 目次

• 前提条件
• クイックスタート
• 連携
• 機能
• 使用方法
• セキュリティに関する注意事項
• トラブルシューティング
• コントリビューション
• ライセンス

🔧 前提条件

• Node.js >= 16.x
• npm >= 8.x
• 以下を備えた Vercel アカウント：
  • アクセストークン
  • チーム ID（任意）
  • プロジェクト ID（任意）
• Cursor IDE または Codeium の Cascade（有料ユーザー向け）

🚀 クイックスタート

📥 インストール

# Clone the repository
git clone https://github.com/Quegenx/vercel-mcp-server.git
cd vercel-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

⚙️ 設定

1. 依存関係をインストールし、プロジェクトをビルドします：

   npm install
   npm run build
   

2. Vercel アクセストークンを設定します：

   • https://vercel.com/account/tokens にアクセスして、アクセストークンを生成します

   • 次の両方のファイルでトークンを更新します：

     src/config/constants.ts 内：

     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // 実際のトークンに置き換えてください
     

     src/index.ts 内：

     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // 実際のトークンに置き換えてください
     

3. Cursor の MCP 設定で、次のコマンドを使ってサーバーを追加します：

   macOS の場合：

   # Default installation
   /usr/local/bin/node /path/to/vercel-mcp/dist/index.js
   
   # Homebrew installation
   /opt/homebrew/bin/node /path/to/vercel-mcp/dist/index.js
   
   # NVM installation
   ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   

   Windows の場合：

   # Default installation
   C:\Program Files\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js
   
   # NVM for Windows
   C:\nvm4w\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js
   
   # Scoop installation
   C:\Users\username\scoop\apps\nodejs\current\node.exe C:\path\to\vercel-mcp\dist\index.js
   

   Linux の場合：

   # Default installation
   /usr/bin/node /path/to/vercel-mcp/dist/index.js
   
   # NVM installation
   ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   

   /path/to/vercel-mcp または C:\path\to\vercel-mcp を、実際のインストール先に置き換えてください。

   Node.js のパスを確認するには：

   # macOS/Linux
   which node
   
   # Windows
   where node
   

注：Vercel アクセストークンは安全に保管し、バージョン管理に絶対にコミットしないでください。

🎯 機能

🎯 利用可能なツール

チーム管理

• チーム：create_team、delete_team、get_team、list_teams、update_team
• チームメンバー：list_team_members、invite_team_member、remove_team_member、update_team_member

プロジェクト管理

• プロジェクト：list_projects、create_project、delete_project、update_project、pause_project
• プロジェクトメンバー：add_project_member、list_project_members、remove_project_member
• プロジェクトの移管：request_project_transfer、accept_project_transfer

デプロイ管理

• デプロイ：create_deployment、cancel_deployment、get_deployment、delete_deployment、list_deployment
• デプロイイベント：get_deployment_events、update_deployment_integration
• デプロイファイル：list_deployment_files、upload_deployment_files、get_deployment_file
• プロモーション：promote_deployment、get_promotion_aliases

ドメインと DNS の管理

• ドメイン：add_domain、remove_domain、get_domain、list_domains、get_project_domain
• ドメイン操作：domain_check、domain_price、domain_config、domain_registry、domain_get、domain_list、domain_buy、domain_register、domain_remove、domain_update
• DNS：create_dns_record、delete_dns_record、list_dns_records、update_dns_record
• 証明書：get_cert、issue_cert、remove_cert、upload_cert

環境と設定

• 環境変数：add_env、update_env、delete_env、get_env、list_env
• Edge Config：create_edge_config、update_edge_config、delete_edge_config、get_edge_config、list_edge_configs
• Edge Config アイテム：list_edge_config_items、get_edge_config_item、update_edge_config_items
• Edge Config スキーマ：get_edge_config_schema、update_edge_config_schema、delete_edge_config_schema
• Edge Config トークン：create_edge_config_token、get_edge_config_token、list_edge_config_tokens、delete_edge_config_tokens
• Edge Config バックアップ：list_edge_config_backups、get_edge_config_backup

アクセス制御とセキュリティ

• アクセスグループ：create_access_group、delete_access_group、update_access_group、get_access_group、list_access_groups
• アクセスグループのプロジェクト：create_access_group_project、delete_access_group_project、get_access_group_project、list_access_group_projects
• アクセスグループのメンバー：list_access_group_members
• 認証：create_auth_token、delete_auth_token、get_auth_token、list_auth_tokens、sso_token_exchange
• ファイアウォール：create_firewall_bypass、delete_firewall_bypass、get_firewall_bypass、get_attack_status、update_attack_mode、get_firewall_config、update_firewall_config、put_firewall_config

モニタリングとログ

• ログドレイン：logdrain_create、logdrain_createIntegration、logdrain_delete、logdrain_deleteIntegration、logdrain_get、logdrain_list、logdrain_listIntegration
• Webhook：create_webhook、delete_webhook、list_webhooks、get_webhook
• アナリティクス：send_web_vitals

ユーザー管理

• ユーザー：delete_user、get_user、list_user_events

マーケットプレイスと連携

• マーケットプレイス：create_marketplace_event、get_marketplace_account、get_marketplace_invoice、get_marketplace_member、import_marketplace_resource、submit_marketplace_billing、submit_marketplace_invoice、update_marketplace_secrets、marketplace_sso_token_exchange、submit_marketplace_balance、marketplace_invoice_action
• 連携：int_delete、int_list、int_gitns、int_searchRepo、int_get、int_updateAction

環境とシークレット

• 環境：create_environment、delete_environment、get_environment、list_environments、update_environment
• シークレット：create_secret、update_secret_name、delete_secret、get_secret、list_secrets

アーティファクトとエイリアス

• アーティファクト：check_artifact、download_artifact、get_artifact_status、query_artifacts、record_artifact_events、upload_artifact
• エイリアス：assign_alias、delete_alias、get_alias、list_aliases、list_deployment_aliases

💡 使い方

設定が完了すると、MCP サーバーから Cursor の Composer を通じて、すべての Vercel 管理ツールを利用できます。Vercel プロジェクトで行いたいことを説明するだけで、AI が適切なコマンドを使用します。

例：

• 📋 「すべてのプロジェクトを一覧表示して」
• 🚀 「新しい Next.js プロジェクトを作成して」
• 🌐 「プロジェクトにカスタムドメインを追加して」
• 🔑 「環境変数を設定して」

🔒 セキュリティに関する注意事項

• 🔐 Vercel アクセストークンを安全に保管してください
• ⚠️ 機密性の高い認証情報をバージョン管理にコミットしないでください
• 👮 適切なアクセス制御と権限を使用してください
• 🛡️ Vercel のセキュリティに関するベストプラクティスに従ってください

🛠️ トラブルシューティング

よくある問題

1. Node.js のパスに関する問題

   • 正しい Node.js のパスを使用していることを確認してください
   • Mac/Linux の場合：which node を使用して正しいパスを確認してください
   • Windows の場合：where node を使用して正しいパスを確認してください

2. アクセストークンに関する問題

   • Vercel アクセストークンが有効であることを確認してください
   • トークンに必要な権限があることを確認してください
   • トークンの有効期限が切れていないことを確認してください

3. MCP がツールを検出しない

   • Cursor の MCP 設定で更新ボタンをクリックしてください
   • サーバーが実行中であること（エラーメッセージが表示されていないこと）を確認してください
   • Vercel の認証情報が有効であることを確認してください

デバッグモード

コマンドの前に DEBUG=true を追加すると、詳細なログを確認できます。

# macOS/Linux
DEBUG=true /usr/local/bin/node /path/to/vercel-mcp/dist/index.js

# Windows
set DEBUG=true && "C:\Program Files\nodejs\node.exe" "C:\path\to\vercel-mcp\dist\index.js"

それでも問題が発生する場合は、以下の情報を添えてイシューを作成してください。

• オペレーティングシステム
• Node.js のバージョン（node --version）
• エラーメッセージ全文
• 再現手順

🤝 コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

📄 ライセンス

---