「fastapi_mcp」实战指南：零配置快速集成 FastAPI 工具到大模型生态

fastapi_mcp 极大简化了将 FastAPI 应用接口开放为 AI 工具集的流程，仅需少量代码即可自动适配 MCP 协议，无需手动配置和维护繁琐的 OpenAPI 文档，让工具型接口更容易被大模型/智能助手集成调用。一个零配置工具，用于自动将FastAPI端点作为模型上下文协议（MCP）工具公开，极大简化了工具型 API 的接入和管理。fastapi_mcp 支持一个 FastAPI 应用

测试游记

655人浏览 · 2025-04-23 21:04:21

测试游记 · 2025-04-23 21:04:21 发布

背景

https://github.com/tadata-org/fastapi_mcp/tree/main

一个零配置工具，用于自动将FastAPI端点作为模型上下文协议（MCP）工具公开，极大简化了工具型 API 的接入和管理。

安装依赖

pip install uvicorn fastapi-mcp

一个最简单的例子

以下代码演示了如何用 fastapi_mcp 快速实现一个 MCP 工具：

from fastapi import FastAPI  
from fastapi_mcp import FastApiMCP  

app = FastAPI()  


@app.get("/text", operation_id="text")  
asyncdef hello_world():
    """  
    测试mcp  
    """    return"Hello World!"


mcp = FastApiMCP(  
    app, name="测试MCP",  
    description="测试",  

)  
mcp.mount(mount_path='/test-mcp')  

if __name__ == '__main__':  
    import uvicorn  

    uvicorn.run(app, host="0.0.0.0", port=8000)

使用Cherry Studio进行测试

image.png

选择「服务器发送事件（see)」
URL:http://127.0.0.1:8000/mcp
在工具中可以看到编写的工具

image.png

直接问AI「测试MCP」就会调用MCP里面的工具完成Hello World的输出

image.png

通过路由区分多个 MCP 工具

fastapi_mcp 支持一个 FastAPI 应用公开多个 MCP 接口，每个接口根据不同业务场景和权限独立管理。

import httpx
from fastapi import FastAPI, Query
from pydantic import BaseModel, Field
from fastapi_mcp import FastApiMCP

app = FastAPI()


class PageRequest(BaseModel):
    pageId: str = Field(description="查询的页面ID")


class PageInfo(BaseModel):
    title: str = Field(description="页面标题")
    html: str = Field(description="页面HTML")
    htmlAfter: str
    markdown: str = Field(description="页面Markdown")


@app.get("/text", operation_id="text")
asyncdef get_text(pageId: str = Query(..., description="要查询的页面ID")):
    """
    测试mcp
    """
    return"Hello World!"


@app.get("/page_info", response_model=PageInfo, operation_id="get_cf_page_info")
asyncdef get_page_info(pageId: str = Query(..., description="要查询的页面ID")):
    """通过 pageId 获取 CF 网页详细信息
    Args:
        pageId: 需要查询的页面唯一标识符 例如https://cf.qunhequnhe.com/pages/viewpage.action?pageId=pageId
    Returns:
        包含标题、页面信息markdown
    """
    target_url = f"http://saas-help-backend-sit.k8s-qunhe.qunhequnhe.com/saas/help/backend/article/pageInfo?pageId={pageId}"
    try:
        response = httpx.get(target_url)
        return response.json()['d']
    except Exception as e:
        raise Exception(f"Error: {e}")


cf_mcp = FastApiMCP(
    app, name="CF相关MCP",
    description="获取CF文档",
    describe_full_response_schema=True,
    describe_all_responses=True,
    include_operations=["get_cf_page_info"],
)
cf_mcp.mount(mount_path='/cf-mcp')

test_mcp = FastApiMCP(
    app, name="测试MCP",
    description="测试",
    describe_full_response_schema=True,
    describe_all_responses=True,
    include_operations=["test"],
)
test_mcp.mount(mount_path='/test-mcp')

if __name__ == "__main__":
    import uvicorn

    uvicorn.run(app, host="0.0.0.0", port=8000)

使用include_operations=["get_cf_page_info"]控制mcp包含的工具
通过cf_mcp.mount(mount_path='/cf-mcp') 来让mcp对外暴露的url变化