FastAPI MCP 快速入门教程

什么是 FastAPI MCP？

FastAPI MCP 是一个将 FastAPI 应用程序转换为 Model Context Protocol (MCP) 服务器的库。它允许 AI 助手通过标准化的协议访问你的 API 端点。

项目设置

1. 初始化项目

uv init fastapi-mcp-quickstart
cd fastapi-mcp-quickstart
uv venv
source .venv/bin/activate  # Linux/Mac
# 或者在 Windows 上：
.venv\Scripts\activate

2. 安装依赖

uv add fastapi-mcp

3. 项目结构

你的项目结构应该如下所示：

fastapi-mcp-quickstart/
├──.venv/
├── .gitignore
├── .python-version
├── README.md
├── main.py
├── pyproject.toml
└── uv.lock

编写代码

创建主应用文件

创建 main.py文件：

from fastapi import FastAPI
from fastapi_mcp import FastApiMCP# Create (or import) a FastAPI app
app = FastAPI()@app.get("/", operation_id="get_user_info")
async def read_user():return {"user_id"}mcp = FastApiMCP(app)mcp.mount()if __name__ == "__main__":import uvicornuvicorn.run(app, host="0.0.0.0", port=8000)

运行和测试

1. 启动服务器

uv run main.py

或者：

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

服务器启动后，你的 MCP 服务器将在 http://127.0.0.1:8000/mcp 运行。

2. 使用 MCP Inspector 测试

打开新的终端窗口，运行 MCP Inspector：

npx @modelcontextprotocol/inspector

然后：

1. 连接到 MCP 服务器：在 Inspector 中输入 http://localhost:8000/mcp
2. 查看可用工具：导航到 “Tools” 部分，点击 “List Tools” 查看所有可用端点
3. 测试端点：
   • 选择一个工具（如 get_user_info）
   • 填写必要参数（如果有）
   • 点击 “Run Tool” 执行
4. 查看结果：检查返回的响应数据