01_FastMCP 2.x 中文文档之FastMCP的介绍
FastMCP 2.x 是一个用于构建模型上下文协议(MCP)服务器和客户端的Python框架,支持通过简洁的代码将LLM连接到工具和数据。它提供高级功能(如服务器组合、OpenAPI生成、企业级认证)和部署工具,适用于生产环境。FastMCP简化协议细节,强调开发效率,其文档支持MCP服务器访问和多种文本格式,便于LLM直接使用。
一、欢迎使用 FastMCP 2.x
快速构建 MCP 服务器和客户端的 Pythonic 方式。
FastMCP 是构建 MCP 应用程序的标准框架。 模型上下文协议(MCP)为连接 LLM 到工具和数据提供了一种标准化方式,而 FastMCP 通过简洁、Pythonic 的代码使其可用于生产环境:
from fastmcp import FastMCP
mcp = FastMCP("Demo 🚀")
@mcp.tool
def add(a: int, b: int) -> int:
"""两数相加"""
return a + b
if __name__ == "__main__":
mcp.run()
二、不止于基础 MCP
FastMCP 是 Python MCP 开发的先驱,其 1.0 版本已于 2024 年并入官方 MCP SDK。
这是 FastMCP 2.x,一个积极维护的版本,其功能远不止于基础的协议实现。虽然 SDK 提供了核心功能,但 FastMCP 2.x 提供了生产环境所需的一切:高级 MCP 模式(服务器组合、代理、OpenAPI/FastAPI 生成、工具转换)、企业级认证(Google、GitHub、Azure、Auth0、WorkOS 等)、部署工具、测试框架以及全面的客户端库。
FastMCP 由 Prefect 💙 精心打造。
三、什么是 MCP?
模型上下文协议(MCP)让您能够构建服务器,以安全、标准化的方式向 LLM 应用程序暴露数据和功能。它通常被描述为“AI 的 USB-C 接口”,为 LLM 连接到可用资源提供了统一的方式。或许可以将其理解为一个专门为 LLM 交互设计的 API。MCP 服务器可以:
- 通过 Resources 暴露数据(可以将其类比为 GET 端点;用于将信息加载到 LLM 的上下文中)
- 通过 Tools 提供功能(可以类比为 POST 端点;用于执行代码或产生其他副作用)
- 通过 Prompts 定义交互模式(用于 LLM 交互的可复用模板)
- 以及更多!
FastMCP 为构建、管理和与这些服务器交互提供了一个高级的、Pythonic 的接口。
四、为什么选择 FastMCP?
FastMCP 处理所有复杂的协议细节,让您可以专注于构建。在大多数情况下,您只需要装饰一个 Python 函数——FastMCP 会处理剩下的事情。
🚀 快速:高级接口意味着更少的代码和更快的开发速度
🍀 简洁:用最少的样板代码构建 MCP 服务器
🐍 Pythonic:让 Python 开发者感觉自然亲切
🔍 功能完备:提供生产环境所需的一切——企业级认证(Google、GitHub、Azure、Auth0、WorkOS)、部署工具、测试框架、客户端库等等
FastMCP 提供了从想法到生产的最短路径。您可以部署到本地、使用 FastMCP Cloud 部署到云端(个人服务器免费)、或部署到您自己的基础设施。
五、便于 LLM 使用的文档
FastMCP 文档提供多种便于 LLM 使用的格式:
5.1 MCP 服务器
FastMCP 文档可通过 MCP 访问!服务器 URL 是 https://gofastmcp.com/mcp。
事实上,您可以使用 FastMCP 来搜索 FastMCP 文档:
import asyncio
from fastmcp import Client
async def main():
async with Client("https://gofastmcp.com/mcp") as client:
result = await client.call_tool(
name="SearchFastMcp",
arguments={"query": "部署 FastMCP 服务器"}
)
print(result)
asyncio.run(main())
5.2 文本格式
文档也提供 llms.txt 格式:
- llms.txt - 列出所有文档页面的站点地图
- llms-full.txt - 包含所有文档的单个文件(可能超出某些模型的上下文窗口限制)
任何页面都可以通过在原 URL 后追加 .md 来获取 Markdown 格式。例如,本页面的 Markdown 版本链接为 https://gofastmcp.com/getting-started/welcome.md。
您也可以通过按键盘上的 “Cmd+C”(或在 Windows 上按 “Ctrl+C”)来复制任何页面的 Markdown 内容。
更多推荐




所有评论(0)