项目简介
这是一个使用 Nuxt 框架构建,并集成 Vercel MCP Adapter 的示例应用。它展示了如何在 Vercel 环境下快速搭建一个符合 Model Context Protocol (MCP) 标准的应用后端,为大型语言模型 (LLM) 客户端提供上下文和功能。
主要功能点
- 托管 MCP 服务器: 提供了运行 MCP 服务器的基础框架。
- 工具注册: 支持注册和声明可供 LLM 调用的工具(例如示例中的 'echo' 工具)。
- 资源和 Prompt 模板: 虽然示例代码中未完全展示,但结构支持托管资源和定义 Prompt 模板。
- 多传输协议支持: 通过 Vercel MCP Adapter 支持不同的 MCP 传输协议(如 SSE)。
- Vercel 优化: 针对 Vercel 平台进行了适配,利用其特性进行部署和运行。
安装步骤
- 克隆仓库。
- 进入项目目录。
- 安装依赖:
pnpm install - (仅开发环境需要)确保本地已运行 Redis 服务器:
redis-server
服务器配置(供 MCP 客户端使用)
该 MCP 服务器作为 Web 服务运行。MCP 客户端连接时,无需通过命令启动服务器进程,而是直接通过网络地址(URL)进行连接。
客户端连接此服务器通常需要以下信息:
- 服务器地址 (URL): 服务器部署后的基础 URL,加上 MCP 服务的基础路径 '/mcp' 和具体的传输协议类型(例如:'http://localhost:3000/mcp/stdio' 或 'https://your-vercel-app.vercel.app/mcp/sse')。
- 传输协议 (transport): 指定使用的传输协议,如 'stdio' 或 'sse'。这会体现在 URL 的路径中。
例如,如果服务器部署在 'https://your-vercel-app.vercel.app',使用 SSE 协议连接,客户端的连接配置会指向该完整 URL。
基本使用方法
- 开发模式运行服务器:
服务器将在 'http://localhost:3000' 启动。pnpm dev - 使用示例客户端连接:
打开另一个终端,运行仓库中提供的示例客户端脚本:
该客户端将尝试连接本地运行的 MCP 服务器并执行示例工具调用。node scripts/test-client.mjs http://localhost:3000
部署到生产环境(如 Vercel)的步骤请参考项目 README 中的说明。
信息
分类
AI与计算