vercel

Vercel MCP サーバー

Vercel REST API を通じて Vercel のデプロイを管理し、アプリケーションのランタイムログを表示する MCP サーバーです。

特長

• デプロイ管理 - デプロイの一覧表示、詳細確認、作成、キャンセル、削除、昇格、ロールバック
• ビルドログとランタイムログ - デバッグ用にビルドログ（イベント）とアプリケーションのランタイムログを表示
• きめ細かなアクセス制御 - 環境変数を使用して、読み取り専用または読み書き可能なツールグループを有効化
• チーム対応 - 特定の Vercel チームを対象に操作

機能

ツール

ツール	グループ	説明
list_deployments	readonly	プロジェクト、ターゲット、状態で絞り込んでデプロイを一覧表示
get_deployment	readonly	ID または URL でデプロイの詳細情報を取得
list_projects	readonly	アカウント／チームのプロジェクトを一覧表示
get_deployment_events	readonly	デプロイのビルドログを取得
get_runtime_logs	readonly	絞り込み条件を指定してアプリケーションのランタイムログを取得
create_deployment	readwrite	新しいデプロイを作成、または再デプロイ
cancel_deployment	readwrite	進行中のデプロイをキャンセル
delete_deployment	readwrite	デプロイを完全に削除
promote_deployment	readwrite	デプロイを本番環境に昇格
rollback_deployment	readwrite	以前のデプロイにロールバック

セットアップ

前提条件

• API トークンを持つ Vercel アカウント（こちらから作成）
• Node.js 18+

設定

変数	必須	説明
VERCEL_TOKEN	はい	Vercel API トークン
VERCEL_TEAM_ID	いいえ	チームを対象とした操作に使用するチーム ID
VERCEL_TEAM_SLUG	いいえ	チームの URL スラッグ（チーム ID の代わりに使用）
VERCEL_ENABLED_TOOLGROUPS	いいえ	カンマ区切りのツールグループ：readonly、readwrite（デフォルト：すべて）

手動セットアップ

# Clone the repository
git clone https://github.com/pulsemcp/mcp-servers.git
cd mcp-servers/experimental/vercel

# Install dependencies
npm install

# Build
npm run build

# Set environment variables
export VERCEL_TOKEN="your-token-here"

# Run
npm start

使用上のヒント

• promote_deployment、rollback_deployment、get_runtime_logs に必要なプロジェクト ID を見つけるには、まず list_projects を使用します
• ランタイムログの保持期間はプランによって異なります：Hobby＝1 時間、Pro＝1 日、Enterprise＝3 日（Observability Plus では最大 30 日）
• 過去のログを検索するには since／until を指定して get_runtime_logs を使用し、特定のエラーを探すには search を、結果を絞り込むには level／source を使用します
• 書き込み操作をすべて無効にするには、VERCEL_ENABLED_TOOLGROUPS=readonly を設定します
• 失敗したデプロイや進行中のデプロイをすばやく見つけるには、state フィルターを指定して list_deployments を使用します

例

デプロイの状態を確認する

「最新のデプロイの状態はどうなっていますか？」

list_deployments を使用して、最近のデプロイとその状態を表示します。

失敗したビルドをデバッグする

「デプロイ dpl_abc123 のビルドログを表示してください」

get_deployment_events を使用して、ビルドの出力とエラーメッセージを表示します。

プレビューを本番環境に昇格する

「プロジェクト prj_xyz789 のデプロイ dpl_abc123 を本番環境に昇格してください」

promote_deployment を使用して、プレビューのデプロイで本番トラフィックを処理できるようにします。

ランタイムエラーを確認する

「my-app の最新デプロイのランタイムログを表示してください」

list_projects でプロジェクト ID を見つけてから、get_runtime_logs で最近のアプリケーションログを表示します。

ログ内の特定のエラーを検索する

「my-app の過去 24 時間に発生したすべての 500 エラーを検索してください」

get_runtime_logs を statusCode: 500 で使用し、since を 24 時間前に設定して、サーバーエラーを絞り込みます。

エッジ関数の問題をデバッグする

「dpl_abc123 のエッジ関数から警告ログとエラーログを表示してください」

get_runtime_logs を source: "edge-function" および level: "error" で使用して、問題を絞り込みます。

開発

# Install dependencies
npm install

# Build
npm run build

# Run functional tests
npm test

# Run integration tests
npm run test:integration

# Run manual tests (requires .env with VERCEL_TOKEN)
npm run test:manual

# Lint
npm run lint