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 (有料ユーザー向け)

🚀 クイックスタート

📥 インストール

⚙️ 構成

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"; // Replace with your actual token
     src/index.ts内:
     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
3. カーソルの 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
• エッジ構成: create_edge_config 、 update_edge_config 、 delete_edge_config 、 get_edge_config 、 list_edge_configs
• エッジ構成項目: list_edge_config_items 、 get_edge_config_item 、 update_edge_config_items
• エッジ構成スキーマ: get_edge_config_schema 、 update_edge_config_schema 、 delete_edge_config_schema
• エッジ構成トークン: create_edge_config_token 、 get_edge_config_token 、 list_edge_config_tokens 、 delete_edge_config_tokens
• エッジ構成のバックアップ: 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がツールを検出しない
   • カーソルのMCP設定の更新ボタンをクリックします
   • サーバーが実行中であることを確認します（エラーメッセージはありません）
   • Vercelの認証情報が有効であることを確認してください

デバッグモード

詳細なログを表示するには、コマンドの前にDEBUG=trueを追加します。

引き続き問題が発生する場合は、次の方法で問題を報告してください:

• オペレーティングシステム
• Node.js バージョン ( node --version )
• 完全なエラーメッセージ
• 再現手順

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

📄 ライセンス