一个用于构建MCP服务器的TypeScript框架。
概览
一个用于构建能够处理客户端会话的MCP服务器的TypeScript框架。 关于Python实现，请参见FastMCP。 FastMCP 是建立在官方 SDK 之上。 官方SDK为构建MCP提供了基础模块，但许多实现细节留给你： - 启动和配置所有服务器组件 - 连接处理 - 工具处理 - 响应处理 - 资源管理 - 添加提示、资源、资源模板 - 嵌入资源、图像和音频内容块 FastMCP通过提供一个有主见的框架，消除了这种复杂性： - 自动处理所有样板程序 - 为常见任务提供简单直观的API——包含内置最佳实践和错误处理 - 让你专注于MCP的核心功能 你希望快速构建MCP服务器，而不必处理底层实现细节。
概述（AI 翻译）
一个用于构建能够处理客户端会话的MCP服务器的TypeScript框架。
[!重要]
FastMCP 实现了基于握手的旧版 MCP 版本（[
2025-11-25及更早版本）。它不支持当前规范2026-07-28，该规范使协议无状态——没有initialize握手和Mcp-Session-Id。针对当前规范的框架请使用 ViteMCP。
特色
- 简单工具、资源、提示词定义
- OpenAPI 至 MCP 转换
- 认证
- 通过上下文传递头部
- 会话ID和请求ID跟踪
- 会议
- 图像内容
- 音频内容
- 嵌入式
- 伐木
- 错误处理
- HTTP 流式传输（支持SSE）
- HTTPS支持安全连接
- REST API、webhook 和管理接口的自定义 HTTP 路由
- 支持 Cloudflare Workers、Deno 部署等的边缘运行时
- 无状态模式用于无服务器部署
- CORS（默认启用）
- 进度通知
- 流媒体输出
- 类型化服务器事件
- 提示论元自动补全
- 抽样
- 引诱
- 可配置的ping行为
- 健康检查端点
- 根源
- 用于单元测试的内存传输，无需绑定端口
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
FastMCP
A TypeScript framework for building MCP servers capable of handling client sessions.
[!IMPORTANT]
FastMCP implements the legacy, handshake-based MCP revisions (
2025-11-25and earlier). It does not support the current specification,2026-07-28, which made the protocol stateless — noinitializehandshake and noMcp-Session-Id. For a framework targeting the current spec, use ViteMCP.
Features
- Simple Tool, Resource, Prompt definition
- OpenAPI to MCP conversion
- Authentication
- Passing headers through context
- Session ID and Request ID tracking
- Sessions
- Image content
- Audio content
- Embedded
- Logging
- Error handling
- HTTP Streaming (with SSE compatibility)
- HTTPS Support for secure connections
- Custom HTTP routes for REST APIs, webhooks, and admin interfaces
- Edge Runtime Support for Cloudflare Workers, Deno Deploy, and more
- Stateless mode for serverless deployments
- CORS (enabled by default)
- Progress notifications
- Streaming output
- Typed server events
- Prompt argument auto-completion
- Sampling
- Elicitation
- Configurable ping behavior
- Health-check endpoint
- Roots
- In-memory transport for unit testing without binding a port
- CLI for testing and debugging
When to use FastMCP over the official SDK?
FastMCP is built on top of the official SDK.
The official SDK provides foundational blocks for building MCPs, but leaves many implementation details to you:
- Initiating and configuring all the server components
- Handling of connections
- Handling of tools
- Handling of responses
- Handling of resources
安装
npx tsx /PATH/TO/YOUR_PROJECT/src/index.ts配置
{
"mcpServers": {
"my-mcp-server": {
"command": "npx",
"args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
"env": {
"YOUR_ENV_VAR": "value"
}
}
}
}