Getting Started 安装指南

# 安装 > 安装 FastMCP 并验证您的设置 ## 安装 FastMCP 我们建议使用 [uv](https://docs.astral.sh/uv/getting-started/installation/) 来安装和管理 FastMCP。 > **注意：** FastMCP 3.0 目前是发布候选版本。包管理器默认不会安装预发布版本——您必须显式请求一个（例如 `>=3.0.0rc1`）。 bash pip install "fastmcp>=3.0.0rc1" 或者使用 uv： bash uv add "fastmcp>=3.0.0rc1" ### 可选依赖 FastMCP 为特定功能提供可选的扩展。例如，要安装后台任务扩展： bash pip install "fastmcp[tasks]==3.0.0rc1" 有关任务系统的详细信息，请参阅后台任务（Background Tasks）。 ### 验证安装 要验证 FastMCP 是否安装正确，您可以运行以下命令： bash fastmcp version 您应该看到如下输出： bash $ fastmcp version FastMCP version: 3.0.0rc1 MCP version: 1.25.0 Python version: 3.12.2 Platform: macOS-15.3.1-arm64-arm-64bit FastMCP root path: ~/Developer/fastmcp ### 依赖许可 > **信息：** FastMCP 依赖 Cyclopts 来实现 CLI 功能。Cyclopts v4 包含 docutils 作为传递依赖，其许可协议较为复杂，可能会在某些组织中触发合规性审查。 如果这是一个问题，您可以安装 Cyclopts v5 alpha，它移除了此依赖： bash pip install "cyclopts>=5.0.0a1" 或者，等待稳定的 v5 版本。有关详细信息，请参阅 [此问题](https://github.com/BrianPugh/cyclopts/issues/672)。 ## 升级 ### 从 FastMCP 2.x 升级 请参阅升级指南以获取重大更改和迁移步骤的完整列表。 ### 从官方 MCP SDK 升级 从官方 MCP SDK 的 FastMCP 1.0 升级到 FastMCP 3.0 通常很简单。核心服务器 API 高度兼容，在许多情况下，将您的导入语句从 `from mcp.server.fastmcp import FastMCP` 更改为 `from fastmcp import FastMCP` 就足够了。 python} # 之前 # from mcp.server.fastmcp import FastMCP # 之后 from fastmcp import FastMCP mcp = FastMCP("My MCP Server") > **警告：** 在 `fastmcp==2.3.0` 和 `mcp==1.8.0` 之前，2.x API 始终镜像官方 1.0 API。然而，随着项目分道扬镳，这一点无法保证。如果您尝试在 FastMCP 3.x 中使用 1.0 API，可能会看到弃用警告。P