项目简介
该项目是一个基于 Model Context Protocol (MCP) 实现的服务器,用于连接大型语言模型 (LLM) 客户端与 Vercel API。它将 Vercel API 的各种功能封装成标准的 MCP 工具,使得 LLM 能够理解并执行对 Vercel 账户资源的 관리 작업 (如部署、域名、项目、环境变量等)。
主要功能点
该服务器提供了一系列工具,允许 LLM 客户端:
- 部署管理: 获取部署详情、列出部署文件、查看部署事件、取消或删除部署。
- DNS 管理: 列出、创建、更新或删除特定域名的 DNS 记录。
- 域名管理: 获取域名配置、获取单个或所有域名的信息。
- 项目管理: 列出、更新项目信息,获取、添加、更新、移除或验证项目域名。
- 环境变量管理: 列出、获取详情、创建、移除或编辑项目的环境变量。
安装步骤
该服务器通常通过 Node.js 包管理器 'npm' 或 'npx' 来运行。确保你的系统中安装了 Node.js。
直接使用 'npx' 运行是推荐的方式,无需全局安装:
npx vercel-mcp VERCEL_API_KEY=<你的Vercel API Key>
请将 '<你的Vercel API Key>' 替换为你实际的 Vercel API Token。你可以在 Vercel 账户设置中生成 API Token。
服务器配置
MCP 服务器通常由 MCP 客户端(如支持 MCP 的 IDE 或应用)启动和管理。客户端需要知道如何启动服务器进程以及传递哪些参数。
对于 'vercel-mcp' 服务器,MCP 客户端需要配置一个启动命令 (command) 和相应的参数 (args)。核心配置信息如下:
- 服务器名称: 'vercel' (这是一个用于标识服务器的名称)
- 启动命令 (command): 'npx'
- 命令参数 (args): '["vercel-mcp", "VERCEL_API_KEY=<你的Vercel API Key>"]' (这告诉 'npx' 执行 'vercel-mcp' 命令,并传递 Vercel API Key 作为参数。请将 '<你的Vercel API Key>' 替换为你的实际 API Token)
MCP 客户端会使用这些信息在你需要使用 Vercel 功能时自动启动并连接到此 MCP 服务器。具体的配置方式请参考你使用的 MCP 客户端(如 Cursor, Windsurf 等)的文档。
基本使用方法
一旦在 MCP 客户端中成功配置并启动了 'vercel-mcp' 服务器,LLM 将能够感知到服务器提供的 Vercel 相关工具。你可以直接向 LLM 发出自然语言指令,例如:
- "List my recent Vercel deployments." (列出我最近的 Vercel 部署)
- "Get the details for deployment with ID 'dpl_xxxxxxxxxxxxxxxxxxxx'." (获取 ID 为 'dpl_xxxxxxxxxxxxxxxxxxxx' 的部署详情)
- "What are the DNS records for domain 'example.com'?" (域名 'example.com' 的 DNS 记录是什么?)
- "List all environment variables for project 'my-website'." (列出项目 'my-website' 的所有环境变量)
LLM 会根据你的指令选择并调用相应的 Vercel 工具来获取信息或执行操作,并将结果通过 MCP 协议返回给你。
信息
分类
开发者工具