如何在 FastAPI-MCP 中注入自定义 httpx.AsyncClient 让 MCP 工具指向远程 API 地址？

如何在 FastAPI-MCP 中注入自定义 httpx.AsyncClient 让 MCP 工具指向远程 API 地址【免费下载链接】fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!项目地址: https://gitcode.com/GitHub_Trending/fa/fastapi_mcp当你不想让业务 API 和 MCP 服务跑在同一台机器上时会碰到一个问题FastAPI-MCP 默认通过 ASGI 直接在进程内调用你的 FastAPI 应用根本不发 HTTP 请求也就没有指向哪个地址这一说。如果你的 FastAPI 应用实际部署在远程服务器上MCP 工具调用就不会到达它。解决办法是向FastApiMCP注入一个自定义的httpx.AsyncClient并把base_url设为远程 API 地址——这样 MCP 工具执行时就会通过真实 HTTP 请求访问远程端点。先理解默认行为为什么需要注入自定义客户端Transport 说明文档指出FastAPI-MCP 默认使用ASGI 传输直接与 FastAPI 应用通信不发出 HTTP 请求也不需要 base URL此时 FastAPI 服务甚至不需要真正运行如果你需要指定自定义 base URL或使用不同的传输方式就可以提供自己的httpx.AsyncClient。从源码 fastapi_mcp/server.py 可以看到不传http_client时内部会自建一个使用httpx.ASGITransport(app...)的客户端进程内直连你的应用一旦传入自定义客户端工具调用就改为按你传入的base_url发起 HTTP 请求。因此让 MCP 工具指向远程 API 的关键就是app对象只作为生成工具定义OpenAPI 模式的来源真正的请求由你注入的客户端发往远程地址。准备条件安装 FastAPI-MCP安装文档uv add fastapi-mcp也可以用pip install fastapi-mcp或uv pip install fastapi-mcp。另外你需要一个可导入的 FastAPIapp对象。它不需要在本机运行仓库示例 examples/04_separate_server_example.py 中就用注释说明了这一点Take the FastAPI app only as a source for MCP server generationFastAPI 应用只作为 MCP 服务器的生成来源。注入自定义 httpx.AsyncClient按 docs/advanced/asgi.mdx 给出的方式创建客户端并传给FastApiMCPimport httpx from fastapi import FastAPI from fastapi_mcp import FastApiMCP app FastAPI() custom_client httpx.AsyncClient( base_urlhttps://api.example.com, timeout30.0 ) mcp FastApiMCP( app, http_clientcustom_client ) mcp.mount()其中base_urlhttps://api.example.com是文档中的示例值替换成你的远程 API 实际地址工具调用时MCP 服务器会在该 base URL 后拼接各端点路径发起请求。timeout用于控制每次工具调用的超时如果你的端点响应较慢可以相应调大见下文调整超时一节。如果客户端需要走 MCP 推荐的 Streamable HTTP 传输也可以按 MCP Transport 文档把mcp.mount()换成mcp.mount_http()两者支持相同的 FastAPI 集成能力自定义路由、认证等。启动服务参考 快速开始文档 的运行方式添加启动入口if __name__ __main__: import uvicorn uvicorn.run(app, host0.0.0.0, port8000)用python fastapi_mcp_server.py换成你的文件名运行后MCP 服务提供在http://localhost:8000/mcp。注意这里启动的是承载 MCP 服务的应用实例而工具调用会被转发到base_url指向的远程 API——两者是分开的。验证工具调用是否真的走了远程 APIFAQ 文档 给出用 MCP Inspector 验证 MCP 服务器是否正常工作的方法启动你的 FastAPI 应用打开新终端运行 MCP Inspectornpx modelcontextprotocol/inspector输入挂载路径 URL 连接你的 MCP 服务器默认http://127.0.0.1:8000/mcp进入Tools区域点击List Tools应能看到由app的端点生成的全部工具选择某个工具、填入参数点击Run Tool执行如有问题查看服务器日志辅助排查。如果你的 MCP 客户端支持 SSE/HTTP也可以直接按 Quickstart 中的配置格式连接例如 Claude Desktop、Cursor 等客户端使用的配置{ mcpServers: { fastapi-mcp: { url: http://localhost:8000/mcp } } }Run Tool返回的结果来自远程 API 端点的响应可以据此判断请求确实到达了远程地址例如在远程端点加日志观察请求来源。可选分支调整工具调用的超时时间仓库中的 examples/07_configure_http_timeout_example.py 展示了只改超时的用法——当你的 API 端点响应超过默认时限该示例注释与 FAQ 均描述默认为 5 秒源码中默认客户端的timeout值为10.0两处略有出入但注入自定义客户端后以你传入的值为准时from examples.shared.apps.items import app # The FastAPI app from examples.shared.setup import setup_logging import httpx from fastapi_mcp import FastApiMCP setup_logging() mcp FastApiMCP(app, http_clienthttpx.AsyncClient(timeout20)) mcp.mount_http() if __name__ __main__: import uvicorn uvicorn.run(app, host0.0.0.0, port8000)这个示例没有设置base_url仍走进程内 ASGI 调用把它和你前面的base_url用法组合就能同时指定远程地址与超时。限制与注意事项工具列表由传入的app的 OpenAPI 模式生成源码 中setup_server基于self.fastapi.routes转换所以远程 API 的路径结构需要与这个app一致FastApiMCP目前只支持由 FastAPI 端点派生的工具见 FAQ。如果在创建并挂载 MCP 服务器之后又给app新增了端点新端点不会自动注册为工具需要调用mcp.setup_server()重新注册见 Refreshing 文档。不要把远程 API 不可用与MCP 服务器启动失败混为一谈MCP 服务器本身正常启动并列出工具不代表远程端点可达Run Tool时才暴露远程连通性问题可结合服务器日志排查。【免费下载链接】fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!项目地址: https://gitcode.com/GitHub_Trending/fa/fastapi_mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考