
FastMCP 作者推出 ViteMCP,用于构建无状态 MCP 服务器的 TypeScript 框架
来源标题:ViteMCP (From the Creator of FastMCP)
FastMCP 作者发布 TypeScript 框架 ViteMCP,专门用于构建无状态 MCP 服务器。该框架面向 MCP 2026-07-28 修订版,取消了 initialize 握手和 Mcp-Session-Id,每个请求自带协议版本与客户端能力。框架还支持工具、资源、提示词、认证及 OpenAPI 生成服务器等功能。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
一个用于构建无状态 MCP 服务器的 TypeScript 框架。 ViteMCP 面向 MCP 2026-07-28 修订版,该版本使协议变为无状态。没有 initialize 握手,也没有 Mcp-Session-Id:每个请求都是自包含的,并携带自己的协议版本和客户端能力。 如果你来自基于会话的版本,请参阅从基于会话的 API 迁移。 功能特性 何时选择 ViteMCP 而非官方 SDK? 安装 快速开始 核心概念 工具 资源 资源模板 嵌入式资源 提示 身份认证 提供指令 服务器元数据与图标 多轮往返请求 可缓存结果 客户端 ID 元数据文档 从 OpenAPI 生成服务器 从基于会话的 API 迁移 服务器功能 日志 自定义 Logger 错误 进度 健康检查端点 部署 HTTP 流式传输 自定义 HTTP 路由 边缘运行时支持 测试与调试 使用内存传输进行单元测试 使用 mcp-cli 测试 使用 MCP Inspector 检查 常见问题 如何配合 Claude Desktop 使用? 如何在代理后面运行 ViteMCP? 案例展示 致谢 身份认证有专门的参考文档——见 OAuth 指南。 OpenAPI 转换同样如此——见 OpenAPI 指南。 简单的工具、资源、提示定义 身份认证 按请求的认证上下文 图像内容 音频内容 嵌入式 错误处理 HTTP 流式传输 HTTPS 支持,用于安全连接 自定义 HTTP 路由,用于 REST API、webhook 和管理界面 边缘运行时支持,适用于 Cloudflare Workers、Deno Deploy 等 构造上无状态——每个请求独立存在,因此无服务器架构可直接运行 CORS(默认启用) 进度通知 多轮往返请求,用于向客户端索取更多输入 提示参数自动补全 可缓存的列表结果(ttlMs / cacheScope) 健康检查端点 从 OpenAPI 文档生成整个服务器 用于单元测试的内存传输,无需绑定端口 用于测试和调试的 CLI 何时选择 ViteMCP 而非官方 SDK? ViteMCP 构建在官方 SDK 之上。 官方 SDK 提供了构建 MCP 的基础模块,但将许多实现细节留给你——而 src/ViteMCP.ts 会替你处理所有这些: ViteMCP 通过提供一个有明确设计取向的框架来消除这种复杂性,该框架: 何时选择 ViteMCP:你想快速构建 MCP 服务器,而不必处理底层实现细节。 何时使用官方 SDK:你需要最大程度的控制权,或有特定的架构要求。在这种情况下,我们建议参考 ViteMCP 的实现,以避免常见陷阱。 npm install @vitemcp/server 快速开始 注意 在真实项目中有许多使用 ViteMCP 的示例。请参阅案例展示了解示例。 import { ViteMCP } from "@vitemcp/server"; import { z } from "zod"; // 或任何支持 Standard Schema 的校验库 const server = new ViteMCP({ name: "My Server", version: "1.0.0", }); server.addTool({ name: "add", description: "Add two numbers", parameters: z.object({ a: z.number(), b: z.number(), }), execute: async (args) => { return String(args.a + args.b); }); server.start({ transportType: "stdio", }); 就是这样!你已拥有一个可运行的 MCP 服务器。 你可以在终端中测试该服务器: git clone https://github.com/vitemcp/server.git cd server pnpm install pnpm build
使用 CLI 测试加法服务器示例:
npx @vitemcp/server dev src/examples/addition.ts
使用 MCP Inspector 测试加法服务器示例:
npx @vitemcp/server inspect src/examples/addition.ts 如果你在寻找起步模板,src/examples/ 中包含可运行的服务器,涵盖工具、身份认证、自定义路由和边缘部署。 工具 MCP 中的工具允许服务器暴露可执行函数,客户端可以调用这些函数,LLM 也可以使用它们来执行操作。 ViteMCP 使用 Standard Schema 规范来定义工具参数。这允许你使用自己偏好的 schema 校验库(如 Zod、ArkType 或 Valibot),只要它实现了该规范即可。 import { z } from "zod"; server.addTool({ name: "fetch-zod", description: "Fetch the content of a url (using Zod)", parameters: z.object({ url: z.string(), }), execute: async (args) => { return await fetchWebpageContent(args.url); }); ArkType 示例: import { type } from "arktype"; server.addTool({ name: "fetch-arktype", description: "Fetch the content of a url (using ArkType)", parameters: type({ url: "string", }), execute: async (args) => { return await fetchWebpageContent(args.url); }); Valibot 示例: Valibot 需要 peer 依赖 @valibot/to-json-schema。 import * as v from "valibot"; server.addTool({ name: "fetch-valibot", description: "Fetch the content of a url (using Valibot)", parameters: v.object({ url: v.string(), }), execute: async (args) => { return await fetchWebpageContent(args.url); }); 纯 JSON Schema 示例: 如果你已经有 JSON Schema——来自 OpenAPI 文档、配置文件或另一个服务器——jsonSchemaAdapter 可以将其包装起来,直接使用,无需中间的 schema 库。 它需要 peer 依赖 ajv 来执行校验,如果你的 schema 使用了 email 或 uri 等 format 关键字,还需要 ajv-formats。 两者都会在首次调用工具时导入,因此不使用此功能的服务器不会有任何开销。 npm install ajv ajv-formats import { jsonSchemaAdapter } from "@vitemcp/server"; server.addTool({ name: "fetch-json-schema", description: "Fetch the content of a url (using plain JSON Schema)", parameters: jsonSchemaAdapter({ type: "object", properties: { url: { type: "string", format: "uri" }, required: ["url"], }), execute: async (args) => { const { url } = args as { url: string }; return await fetchWebpageContent(url); }); 同样适用于 outputSchema,并且会按原样声明——Zod 和 ArkType 的 schema 也是如此,它们会生成自己的 JSON Schema。当其中某种 schema 包含 JSON Schema 无法表达的内容时——例如 z.date()、z.bigint()、某个 ArkType
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。