FastMCP 是用于构建 MCP 服务器的 Python 框架,让 Claude 等大语言模型能够调用你定义的工具、资源和提示词。安装方式为 pip install fastmcp 或 uv pip install fastmcp。
主要能力:通过 @mcp.tool() 装饰器把函数暴露为 LLM 可调用的工具,建议使用清晰函数名、完整 docstring、类型提示并返回结构化数据;通过 @mcp.resource() 暴露静态或带参数的动态数据,URI 支持 data://、file://、resource://、info://、api:// 等;通过 @mcp.prompt() 提供预配置提示词。Context 支持进度上报与用户确认输入。
使用方式:服务器对象必须定义在模块层级,便于 FastMCP Cloud 使用。本地运行 python server.py,或用 fastmcp dev server.py 开发模式、fastmcp run server.py 生产模式、fastmcp deploy server.py 部署到 FastMCP Cloud、fastmcp test server.py 运行测试。HTTP 模式可加 --transport http --port 8000。客户端可在 Claude Desktop 或 Claude Code CLI 的 mcpServers 配置中指定 command 与 args。
生产特性:存储后端可选内存(仅开发)、磁盘(单实例)、Redis(多实例),可配合 Fernet 加密;lifespan 在 v2.13.0+ 按服务器运行一次,用于初始化连接;内置日志、计时、限流、响应缓存等中间件,顺序会影响行为;支持 import_server 静态导入与 mount 动态挂载进行服务器组合。
限制与注意:常见错误包括服务器对象未在模块层级、同步函数中误用 await、Context 参数缺少类型提示、生产环境未配置存储导致 OAuth 令牌丢失、循环导入等。生产环境应使用加密的磁盘或 Redis 存储。具体收费、价格与平台支持情况暂未提供。