一个 MCP 代理服务器,通过单一 HTTP 入口聚合并转发多个 MCP 服务。
punkpeye/fastmcp
用于构建 MCP 服务器的 TypeScript 框架,支持会话管理、工具、资源和提示词。
- Star
- 3,278
- Fork
- 332
- 未关闭 Issue
- 5
- 最近提交
- 11小时前
这是什么?
FastMCP 是一个用于构建 Model Context Protocol(MCP)服务器的 TypeScript 框架,底层基于官方 SDK。它封装了服务器组件的初始化、连接处理以及工具、资源和提示词的响应格式化等重复工作,开发者只需几行代码即可定义一个工具。参数校验可使用 Zod、ArkType、Valibot,也可直接使用普通 JSON Schema。
服务器可通过 stdio、兼容 SSE 的 HTTP 流或 HTTPS 运行,并支持有状态和无状态两种部署方式。框架还提供认证、请求头与会话 ID 追踪、采样、信息请求(elicitation)、进度通知,以及基于 Hono 的自定义 HTTP 路由。针对 Cloudflare Workers 和 Deno Deploy 等边缘运行时,还提供 EdgeFastMCP 变体。
该项目面向 2025-11-25 及更早的基于握手的 MCP 协议版本,不支持无状态的 2026-07-28 规范。
核心功能
- 01通过简洁的 API 定义工具、资源和提示词。
- 02支持用 Zod、ArkType、Valibot 或普通 JSON Schema 校验参数。
- 03可通过 stdio、兼容 SSE 的 HTTP 流或 HTTPS 提供服务。
- 04支持有状态和无状态运行模式,也可部署到边缘运行时。
- 05内置认证、可自定义的 Hono HTTP 路由和健康检查端点。
- 06提供内存传输用于单元测试,并配有命令行工具和 MCP Inspector 调试支持。
适用场景
- 将内部 API 或数据库封装为 LLM 客户端可调用的工具。
- 搭建通过 HTTP 远程访问的 MCP 服务器。
- 将 MCP 服务器部署到 Cloudflare Workers 或 Deno Deploy。
- 在不占用网络端口的情况下为 MCP 服务器编写单元测试。
快速上手
- 1
从 npm 安装 fastmcp 包
npm install fastmcp - 2
按照 README 中的快速开始代码编写服务器文件,并使用 server.start() 启动
使用前须知
- FastMCP 仅支持基于握手的旧版 MCP 规范(2025-11-25 及更早版本),不支持当前无状态的 2026-07-28 规范。
标签
常见问题
- fastmcp 是什么?
- 用于构建 MCP 服务器的 TypeScript 框架,支持会话管理、工具、资源和提示词。 FastMCP 是一个用于构建 Model Context Protocol(MCP)服务器的 TypeScript 框架,底层基于官方 SDK。它封装了服务器组件的初始化、连接处理以及工具、资源和提示词的响应格式化等重复工作,开发者只需几行代码即可定义一个工具。参数校验可使用 Zod、ArkType、Valibot,也可直接使用普通 JSON Schema。
- fastmcp 可以免费使用吗?用的什么许可证?
- fastmcp 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- fastmcp 还在维护吗?
- 活跃维护中。fastmcp 最近一次提交是在 2026年10月22日。
- fastmcp 适合用来做什么?
- 将内部 API 或数据库封装为 LLM 客户端可调用的工具。 搭建通过 HTTP 远程访问的 MCP 服务器。 将 MCP 服务器部署到 Cloudflare Workers 或 Deno Deploy。 在不占用网络端口的情况下为 MCP 服务器编写单元测试。
- fastmcp 怎么安装和运行?
- 从 npm 安装 fastmcp 包: npm install fastmcp 按照 README 中的快速开始代码编写服务器文件,并使用 server.start() 启动
- 在哪里获取 fastmcp?
- 源代码和安装说明在 GitHub 上:https://github.com/punkpeye/fastmcp
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
用 Go 编写的超轻量个人 AI 助手,可在低成本硬件上运行,并接入多种大模型与聊天应用。
一款开源终端编程智能体 CLI,可接入云端 API 和 Ollama 等本地模型。
将整个代码仓库打包成单个 AI 友好文件,方便输入给 Claude、ChatGPT 等大模型的命令行与网页工具。
基于 Cloudflare 构建 AI 应用的 TypeScript 包与示例,提供 Vercel AI SDK 和 TanStack AI 的适配器。
一款 AI 提示词优化工具,可优化、测试、对比提示词效果,并保存为可复用资产,支持网页、桌面、Chrome 扩展和 Docker 部署。