​
安装FastMCP

我们推荐使用uv来安装和管理FastMCP。

如果您计划在项目中使用FastMCP，可以通过以下方式添加依赖：

uv add fastmcp

或者，您可以直接使用pip或uv pip进行安装：

uv pip install fastmcp

​
验证安装

要验证FastMCP是否正确安装，您可以运行以下命令：

fastmcp version

您应该会看到类似以下的输出：

$ fastmcp version

FastMCP version:   0.4.2.dev41+ga077727.d20250410
MCP version:                                1.6.0
Python version:                            3.12.2
Platform:            macOS-15.3.1-arm64-arm-64bit
FastMCP root path:            ~/Developer/fastmcp

​
从官方MCP SDK升级

从官方MCP SDK的FastMCP 1.0升级到FastMCP 2.0通常很简单。核心服务器API高度兼容，在许多情况下，只需将导入语句从from mcp.server.fastmcp import FastMCP改为from fastmcp import FastMCP就足够了。

# Before
# from mcp.server.fastmcp import FastMCP

# After
from fastmcp import FastMCP

mcp = FastMCP("My MCP Server")

在fastmcp==2.3.0和mcp==1.8.0版本之前，2.x API始终与1.0 API保持一致。但随着项目的发展，这种兼容性将无法保证。如果您在FastMCP 2.x中使用1.0 API，可能会看到弃用警告。有关新功能的详细信息，请参阅本文档。

​
开发环境安装指南

如果您计划为FastMCP做贡献，应该首先克隆代码库并使用uv安装所有依赖项（开发依赖项会自动安装）：

git clone https://github.com/jlowin/fastmcp.git
cd fastmcp
uv sync

这将安装所有依赖项，包括开发所需的依赖项，并创建一个虚拟环境，您可以像平常一样激活并使用它。

​
单元测试

FastMCP拥有全面的单元测试套件，所有PR都必须引入并通过适当的测试。要运行测试，请使用pytest：

pytest

​
预提交钩子

FastMCP使用pre-commit来管理代码质量，包括格式化、代码检查和类型安全。所有PR都必须通过pre-commit钩子检查，这些检查是CI流程的一部分。要安装pre-commit钩子，请运行：

uv run pre-commit install

或者，要随时手动运行 pre-commit，请使用：

pre-commit run --all-files