FastAPI MCP 快速入门教程
目录
- 什么是 FastAPI MCP?
- 项目设置
- 1. 初始化项目
- 2. 安装依赖
- 3. 项目结构
- 编写代码
- 创建主应用文件
- 运行和测试
- 1. 启动服务器
- 2. 使用 MCP Inspector 测试
什么是 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
然后:
- 连接到 MCP 服务器:在 Inspector 中输入
http://localhost:8000/mcp
- 查看可用工具:导航到 “Tools” 部分,点击 “List Tools” 查看所有可用端点
- 测试端点:
- 选择一个工具(如
get_user_info
) - 填写必要参数(如果有)
- 点击 “Run Tool” 执行
- 选择一个工具(如
- 查看结果:检查返回的响应数据