使用说明

项目简介

Vercel MCP服务器是一个基于 Model Context Protocol (MCP) 实现的后端应用,旨在为AI系统和人类提供结构化的Vercel API交互方式。它允许用户通过终端或AI客户端,以标准化的方式管理Vercel项目、部署、域名、环境变量等资源,并执行相关操作。

主要功能点

  • Vercel API 交互: 通过工具的方式封装了Vercel REST API的常见操作。
  • 资源管理: 提供项目、部署、域名、环境变量等Vercel资源的查询和管理能力。
  • 工具化操作: 预置了多种实用工具,如列出项目、部署、获取项目信息、管理域名和环境变量等。
  • 交互式终端客户端: 提供一个简单的终端界面,方便用户直接与Vercel MCP服务器交互,体验各项功能。
  • AI 友好接口: 遵循 MCP 协议,可以方便地与支持 MCP 协议的 AI 客户端集成,实现通过 AI 自动化管理 Vercel 资源。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/jasona7/mcp-vercel-server.git
    cd mcp-vercel-server
  2. 安装依赖: 确保已安装 Python 3.6 或更高版本,然后运行以下命令安装项目依赖:

    pip install requests rich fastmcp
  3. 配置 Vercel API Token: 你需要一个 Vercel API Token 来让服务器能够访问你的 Vercel 账户。

    • 访问 https://vercel.com/account/tokens 创建或获取你的 Token。
    • 将 Token 设置为环境变量 'VERCEL_TOKEN':
      export VERCEL_TOKEN=你的_vercel_token
      或者,你也可以在运行服务器之前,直接在终端中设置环境变量。

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 Vercel MCP 服务器。以下是配置示例,请复制到你的 MCP 客户端配置中:

{
  "serverName": "Vercel MCP Server",
  "command": "python",
  "args": ["mcp_vercel_server.py"],
  "host": "http://127.0.0.1:8002"
}

配置参数说明:

  • 'serverName': 服务器名称,可以自定义,用于在客户端显示,例如 "Vercel MCP Server"。
  • 'command': 启动服务器的命令,这里是 'python',假设你的 Python 环境配置正确。
  • 'args': 启动命令的参数,这里是服务器脚本 'mcp_vercel_server.py'。
  • 'host': MCP 服务器的地址,默认情况下,Vercel MCP 服务器运行在 'http://127.0.0.1:8002'。

注意: 请确保在运行 MCP 客户端之前,先启动 Vercel MCP 服务器。

基本使用方法

  1. 启动 MCP 服务器: 在终端中,导航到 'mcp-vercel-server' 仓库目录,并运行以下命令启动服务器:

    python mcp_vercel_server.py

    服务器成功启动后,会显示 "Server started at http://0.0.0.0:8002" 等信息。

  2. 使用 MCP 客户端 (可选): 仓库中提供了一个简单的终端客户端 'mcp_vercel_client.py' 用于测试和交互。你可以另开一个终端窗口,导航到仓库目录,并运行客户端:

    python mcp_vercel_client.py

    客户端会连接到服务器,并显示可用的操作菜单。按照菜单提示,即可与 Vercel API 进行交互。

  3. 集成到 AI 客户端: 如果你使用支持 MCP 协议的 AI 客户端,例如 AI Agent 平台或工具,则可以将上面提供的服务器配置信息填入 AI 客户端的 MCP 服务器配置中。配置完成后,AI 客户端即可通过 MCP 协议调用 Vercel MCP 服务器提供的工具,从而实现对 Vercel 平台的自动化操作。

信息

分类

开发者工具