Repolode
punkpeye

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. 1

    从 npm 安装 fastmcp 包

    npm install fastmcp
  2. 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 数据每日更新。

相关项目