使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 应用提供访问 Mantle 网络协议统计数据的能力。它通过定义和注册工具，允许 LLM 客户端查询特定艺术家的粉丝和社交媒体帖子信息，从而增强 LLM 在相关领域的上下文理解和决策能力。

主要功能点

提供数据访问工具: 实现了 'get_artist_fans' 和 'get_artist_posts' 两个工具，允许 LLM 获取指定艺术家的粉丝列表和帖子列表。
基于 MCP 协议: 完全遵循 MCP 协议规范，支持客户端通过 JSON-RPC 与服务器进行通信，实现工具发现和调用。
SSE 和 HTTP 传输: 支持 SSE (Server-Sent Events) 长连接和 HTTP POST 两种传输协议，满足不同客户端的需求。
Vercel 部署优化: 专为 Vercel 平台设计，易于部署和扩展，并利用 Vercel 的 Fluid Compute 特性提高效率。
Redis 会话管理: 使用 Redis 进行会话管理和消息队列，保证服务器的稳定性和可伸缩性。

安装步骤

克隆仓库: 将 GitHub 仓库 'https://github.com/recoupable/mcp-vercel' 克隆到本地。
安装依赖: 在项目根目录下运行 'npm install' 或 'yarn install' 安装项目依赖。
配置 Redis: 确保已在 Vercel 项目中配置 Redis 实例，并将 Redis 连接 URL 设置在环境变量 'REDIS_URL' 或 'KV_URL' 中。
启用 Fluid Compute (可选): 为了获得更高效的执行性能，建议在 Vercel 项目中启用 Fluid Compute。
调整最大执行时长 (可选): 如果使用 Vercel Pro 或 Enterprise 账户，可以修改 'vercel.json' 文件，将 'api/server.ts' 函数的最大执行时长 'maxDuration' 调整为 800 秒。
部署到 Vercel: 使用 Vercel CLI 运行 'vercel deploy --prod' 命令将项目部署到 Vercel。

服务器配置

MCP 客户端需要配置以下信息以连接到此 MCP 服务器：

{
  "serverName": "mantle-stats-mcp-server",
  "command": "https://<YOUR_VERCEL_DEPLOYMENT_URL>/api/server",
  "args": [],
  "transport": "sse",
  "description": "Mantle Network Statistics MCP Server"
}

配置参数说明:

'serverName': 服务器名称，可以自定义，例如 '"mantle-stats-mcp-server"'。
'command': 重要 - 部署到 Vercel 后，Vercel 提供的项目部署 URL，需要将 '<YOUR_VERCEL_DEPLOYMENT_URL>' 替换为实际的 Vercel 部署地址。指向服务器的入口 '/api/server'。
'args': 启动参数，本服务器不需要额外的启动参数，保持为空数组 '[]' 即可。
'transport': 传输协议，本服务器默认使用 SSE，设置为 '"sse"'。
'description': 服务器描述，可以自定义，方便客户端识别。

基本使用方法

启动 MCP 客户端: 配置好上述服务器连接信息后，启动您的 MCP 客户端。
发现工具: 客户端应能自动发现服务器提供的 'get_artist_fans' 和 'get_artist_posts' 工具。
调用工具: 通过客户端界面或 API，可以调用这些工具，例如，调用 'get_artist_fans' 工具并传入 'artist_account_id' 参数，即可获取指定艺术家的粉丝列表。
接收结果: 服务器会将工具执行结果以 JSON-RPC 响应的形式返回给客户端。

示例工具调用 (自然语言描述):

"请帮我查找艺术家账号 ID 为 '0x123abc456def' 的粉丝列表。"

客户端会将此自然语言请求转换为对 'get_artist_fans' 工具的调用，并传递 'artist_account_id: "0x123abc456def"' 参数给 MCP 服务器。服务器执行工具后，返回包含粉丝信息的 JSON 响应。

关键词