01_FastMCP 2.x 中文文档之FastMCP的介绍

一、欢迎使用 FastMCP 2.x

快速构建 MCP 服务器和客户端的 Pythonic 方式。

FastMCP 是构建 MCP 应用程序的标准框架。 模型上下文协议（MCP）为连接 LLM 到工具和数据提供了一种标准化方式，而 FastMCP 通过简洁、Pythonic 的代码使其可用于生产环境：

from fastmcp import FastMCPmcp = FastMCP("Demo 🚀")@mcp.tool
def add(a: int, b: int) -> int:"""两数相加"""return a + bif __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 Clientasync 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 内容。