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

本文链接：https://blog.youkuaiyun.com/software_test010/article/details/147490260

📝 面试求职： 「面试试题小程序」，内容涵盖测试基础、Linux操作系统、MySQL数据库、Web功能测试、接口测试、APPium移动端测试、Python知识、Selenium自动化测试相关、性能测试、性能测试、计算机网络知识、Jmeter、HR面试，命中率杠杠的。（大家刷起来…）

📝 职场经验干货：

软件测试工程师简历上如何编写个人信息（一周8个面试）

软件测试工程师简历上如何编写专业技能（一周8个面试）

软件测试工程师简历上如何编写项目经验（一周8个面试）

软件测试工程师简历上如何编写个人荣誉（一周8个面试）

软件测试行情分享（这些都不了解就别贸然冲了.）

软件测试面试重点，搞清楚这些轻松拿到年薪30W+

软件测试面试刷题小程序免费使用（永久使用）

背景

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进行测试

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

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

通过路由区分多个 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变化