03_FastMCP 2.x 中文文档之FastMCP快速入门

一、快速入门

欢迎！本指南将帮助您快速设置 FastMCP，运行您的第一个 MCP 服务器，并将服务器部署到 FastMCP Cloud。

如果尚未安装 FastMCP，请先按照安装说明进行操作。

二、创建 FastMCP 服务器

FastMCP 服务器是工具、资源和其他 MCP 组件的集合。要创建服务器，请先实例化 FastMCP 类。

创建一个名为 my_server.py 的新文件，并添加以下代码：

复制代码

from fastmcp import FastMCP

mcp = FastMCP("我的 MCP 服务器")

完成！您已经创建了一个 FastMCP 服务器，虽然目前还很基础。让我们添加一个工具来让它变得更有趣。

2.1 添加工具

要添加一个返回简单问候语的工具，请编写一个函数并使用 @mcp.tool 装饰器将其注册到服务器：

复制代码

from fastmcp import FastMCP

mcp = FastMCP("我的 MCP 服务器")

@mcp.tool
def greet(name: str) -> str:
    return f"你好，{name}！"

2.2 运行服务器

运行 FastMCP 服务器最简单的方法是调用其 run() 方法。您可以选择不同的传输方式，例如用于本地服务器的 stdio

复制代码

from fastmcp import FastMCP

mcp = FastMCP("我的 MCP 服务器")

@mcp.tool
def greet(name: str) -> str:
    return f"你好，{name}！"

if __name__ == "__main__":
    mcp.run()

或用于远程访问的 http：

复制代码

from fastmcp import FastMCP

mcp = FastMCP("我的 MCP 服务器")

@mcp.tool
def greet(name: str) -> str:
    return f"你好，{name}！"

if __name__ == "__main__":
    mcp.run(transport="http", port=8000)

这样我们就可以使用 python my_server.py 运行服务器。stdio 传输是将 MCP 服务器连接到客户端的传统方式，而 HTTP 传输则支持远程连接。

为什么需要 if name == "main ": 代码块？

建议使用 main 代码块以确保一致性和兼容性，这样能保证您的服务器与所有将服务器文件作为脚本执行的 MCP 客户端兼容。如果用户只使用 FastMCP CLI 运行服务器，则可以省略该代码块，因为 CLI 会直接导入服务器对象。

2.3 使用 FastMCP CLI

您也可以使用 fastmcp run 命令来启动服务器。请注意，FastMCP CLI 不会执行服务器文件的 main 代码块。相反，它会导入您的服务器对象，并使用您提供的任何传输方式和选项来运行它。

例如，要使用默认的 stdio 传输运行此服务器（无论您在 mcp.run() 中如何设置），可以使用以下命令：

复制代码

fastmcp run my_server.py:mcp

要使用 HTTP 传输运行此服务器，可以使用以下命令：

复制代码

fastmcp run my_server.py:mcp --transport http --port 8000

三、调用 MCP 服务器

当您的服务器通过 HTTP 传输运行时，您可以使用 FastMCP 客户端或任何支持 MCP 协议的 LLM 客户端连接到它：

复制代码

import asyncio
from fastmcp import Client

client = Client("http://localhost:8000/mcp")

async def call_tool(name: str):
    async with client:
        result = await client.call_tool("greet", {"name": name})
        print(result)

asyncio.run(call_tool("张三"))

请注意：

FastMCP 客户端是异步的，因此我们需要使用 asyncio.run 来运行客户端
在使用客户端之前，我们必须进入客户端上下文（async with client:）
您可以在同一个上下文中进行多次客户端调用

四、部署到 FastMCP Cloud

FastMCP Cloud 是由 Prefect 的 FastMCP 团队运营的托管服务。它经过优化，可以尽可能快速地部署经过身份验证的 FastMCP 服务器，为您提供一个安全的 URL，可以插入任何 LLM 客户端。

FastMCP Cloud 对个人服务器免费，并为团队提供简单的按需付费定价。

要部署您的服务器，您需要一个 GitHub 账户。拥有账户后，您可以通过三个步骤部署服务器：

将您的 my_server.py 文件推送到 GitHub 仓库
使用您的 GitHub 账户登录 FastMCP Cloud
从您的仓库创建一个新项目，并输入 my_server.py:mcp 作为服务器入口点

完成！FastMCP Cloud 将构建并部署您的服务器，使其在类似 https://your-project.fastmcp.app/mcp 的 URL 上可用。您可以与其聊天以测试其功能，或从任何支持 MCP 协议的 LLM 客户端连接到它。

有关更多详细信息，请参阅 FastMCP Cloud 指南。