如何用 fastmcp-slim[client] 只安装 FastMCP 客户端依赖而不用完整服务端框架?

发布时间:2026/9/13 10:23:23
如何用 fastmcp-slim[client] 只安装 FastMCP 客户端依赖而不用完整服务端框架? 如何用 fastmcp-slim[client] 只安装 FastMCP 客户端依赖而不用完整服务端框架【免费下载链接】fastmcp The fast, Pythonic way to build MCP servers and clients.项目地址: https://gitcode.com/GitHub_Trending/fa/fastmcp如果你的代码只是连接MCP 服务器远程 HTTP 端点或本地子进程而自己不定义、不运行任何 FastMCP 服务器那么不需要安装包含完整服务端框架的fastmcp发行包。FastMCP 3.3 起提供了精简发行包fastmcp-slim通过[client]extra 只引入客户端与传输层所需的依赖不带 Uvicorn 等服务端组件。装完后代码写法不变仍然是from fastmcp import Client。适用场景与前提按 Client-Only Package 文档client-only 安装适用于你的程序连接 MCP 服务器但不在本进程内定义或运行 FastMCP 服务器框架作者在自己的包里提供 MCP 连接能力不想让用户被迫安装完整 FastMCP 服务端栈。环境前提来自 fastmcp_slim/pyproject.tomlPython 3.10fastmcp-slim自 FastMCP 3.3文档版本标注为 3.3.0起提供。以下情况不能只用fastmcp-slim[client]需要完整包定义或运行 FastMCP 服务器FastMCP对象内存客户端直接连接FastMCP服务器对象如Client(server)多服务器 MCP 配置一次配置里挂多个mcpServersFastMCP apps、代理、服务器鉴权、中间件等服务端功能。安装pip install fastmcp-slim[client][client]extra 会连带安装fastmcp-slim[mcp]MCP SDK 与传输层、authlib和py-key-value-aio具体依赖清单见 fastmcp_slim/pyproject.toml 的optional-dependencies。按 3.3 版发布说明见 changelog这次拆分的目的就是让客户端与传输层可以独立于 Starlette、Uvicorn 等服务端机制安装。如果你还需要采样sampling处理器用同一个包加对应的 extrapip install fastmcp-slim[client,openai] pip install fastmcp-slim[client,anthropic] pip install fastmcp-slim[client,gemini]基本用法client-only 安装使用与完整包相同的fastmcp导入命名空间两个发行包暴露的应用代码完全一致见 FAQ。支持远程与子进程两种传输方式from pathlib import Path from fastmcp import Client # 远程 MCP 服务器 http_client Client(https://example.com/mcp) # 本地 MCP 服务器stdio 子进程 stdio_client Client(Path(my_server.py))单服务器 MCP 配置同样可用from fastmcp import Client config { mcpServers: { weather: { url: https://weather.example.com/mcp } } } client Client(config)上面的 URL 是文档中的示例地址实际使用时替换为你自己的 MCP 端点。验证安装client-only 安装不包含 CLI 支持CLI 属于 server extra见 fastmcp_slim/fastmcp/_install_hints.py 中的提示文本所以完整安装文档里的fastmcp version命令不适用于这种装法。直接用 Python 导入验证即可import fastmcp from fastmcp import Client print(fastmcp.__version__)fastmcp.__version__读取的是fastmcp-slim发行包的版本见 fastmcp_slim/fastmcp/init.py。能顺利打印版本且无 ImportError说明客户端依赖装好了下一步就是按上一节的方式构造Client并连接你的服务器。常见报错与边界提示FastMCP client support is not installed. Install fastmcp or fastmcp-slim[client].这是只装了裸fastmcp-slim不带[client]extra时访问Client得到的友好 ImportError提示文案同样来自 fastmcp_slim/fastmcp/_install_hints.py。补装对应 extra 即可。多服务器配置报 ImportErrorclient-only 包目前只支持单服务器配置多服务器场景会抛出要求安装完整fastmcp的 ImportError测试见 tests/client/test_slim_package_boundaries.py。需要多服务器时改装pip install fastmcp。不要同时安装fastmcp和fastmcp-slim两个发行包含相同的可导入文件安装文档的故障排查给出的清理流程是先pip uninstall -y fastmcp fastmcp-slim再从干净状态重装其一。pip 升级导致的import fastmcp失败仅影响用 pip 从 FastMCP 3.2 或更早升级到 3.3 及以上的情形全新安装和uv升级不受影响。若遇到按文档用pip install --force-reinstall fastmcp恢复。何时换回完整包一旦开始定义或运行服务器、使用内存客户端、多服务器配置或 apps/代理/鉴权/中间件等能力就改装完整包导入方式不变pip install fastmcp完整包仍是大多数用户的默认选择from fastmcp import Client, FastMCP的原有写法继续支持。【免费下载链接】fastmcp The fast, Pythonic way to build MCP servers and clients.项目地址: https://gitcode.com/GitHub_Trending/fa/fastmcp创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考