项目简介

这是一个使用 Nuxt 框架构建,并集成 Vercel MCP Adapter 的示例应用。它展示了如何在 Vercel 环境下快速搭建一个符合 Model Context Protocol (MCP) 标准的应用后端,为大型语言模型 (LLM) 客户端提供上下文和功能。

主要功能点

  • 托管 MCP 服务器: 提供了运行 MCP 服务器的基础框架。
  • 工具注册: 支持注册和声明可供 LLM 调用的工具(例如示例中的 'echo' 工具)。
  • 资源和 Prompt 模板: 虽然示例代码中未完全展示,但结构支持托管资源和定义 Prompt 模板。
  • 多传输协议支持: 通过 Vercel MCP Adapter 支持不同的 MCP 传输协议(如 SSE)。
  • Vercel 优化: 针对 Vercel 平台进行了适配,利用其特性进行部署和运行。

安装步骤

  1. 克隆仓库。
  2. 进入项目目录。
  3. 安装依赖:
    pnpm install
  4. (仅开发环境需要)确保本地已运行 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。

基本使用方法

  1. 开发模式运行服务器:
    pnpm dev
    服务器将在 'http://localhost:3000' 启动。
  2. 使用示例客户端连接: 打开另一个终端,运行仓库中提供的示例客户端脚本:
    node scripts/test-client.mjs http://localhost:3000
    该客户端将尝试连接本地运行的 MCP 服务器并执行示例工具调用。

部署到生产环境(如 Vercel)的步骤请参考项目 README 中的说明。

信息

分类

AI与计算