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 )

• 完全なエラーメッセージ

• 再現手順

🤝 貢献する

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

📄 ライセンス