fastmcp

[FastMCP设计、原理与应用-17]从服务器向客户端的反向通知从通信或者消息交换模式来看，前面涉及的都是从客户端发送请求到服务器并得到对应的响应，这是典型的从客户端到服务器的请求/响应模式，接下来我们介绍两种从服务器向客户端的反向通信模式：

06_系统架构设计配套视频教程： 👉《智能体微服务架构企业级实战教程》共72节更多文章专栏内容： 👉《智能体微服务架构企业级实战教程》专栏

[FastMCP设计、原理与应用-15]挂载一个MCP服务器就像挂载一个目录一样容易随着应用程序的增长，我们需要将其拆分为多个功能专一的服务器（例如一个用于天气，一个用于日历，一个用于管理后台），并通过挂载（Mount）的方式将它们合并成一个客户端连接的单一服务器。挂载服务器后，其所有工具、资源和提示都会通过父进程变为可用状态。连接是实时的，挂载后向子进程添加工具，该工具会立即在父进程中可见。

[FastMCP设计、原理与应用-14]FastMCP——架构之魂，构建MCP应用的统一入口与调度中枢作为一个MCP服务器，FastMCP在底层需要建立一个面向传输（STDIO、SSE和Streamable-HTTP）的服务器用于建立和维护于客户端的连接，并在此基础上完成与客户端的消息交互。具体的消息交互具有如下几种模式：

[FastMCP设计、原理与应用-11]Transform——数据炼金术，跨协议边界的无缝适配与格式转换Transform核心作用是在MCP服务器处理请求的生命周期中，允许我们拦截、修改或过滤工具、资源（包括静态资源和动态资源模板）和提示词（模板）的读取。

[FastMCP设计、原理与应用-02]以命令行和客户端与MCP服务器交互在"Hello, MCP"，我们采用HTTP传输协议搭建了一个简单FastMCP服务器，并直接采用HTTP请求的形式完整MCP的基本操作，包括读取组件列表、调用工具、读取资源和渲染提示词等操作。接下来我们来演示其他两种交互方法，一是使用fastmcp命令行，而是以编程的方式是客户端SDK。

03_《智能体微服务架构企业级实战教程》能学到什么本课程以旅游出行攻略智能助手为实战项目，系统讲解基于FastMCP、LangGraph、DeepSeek大模型与微服务架构构建生产级智能体系统的完整流程。课程覆盖架构设计、模块开发至容器化部署，融入日志、链路追踪、认证、重试降级等企业级实践，由资深架构师主讲，代码源自真实项目，助力学员掌握可落地的智能体微服务开发能力。

AI-MCP-SQLite-SSE本地服务及CherryStudio便捷应用咨询：用一个文件基于FastMcp库本地编码搭建简单MCP服务，实现本地SQLite数据库的基本访问，所有功能可以在浏览器窗口测试。在Cherry Studio可视环境做MCP部署与运行。

AI-MCP本地流媒音频服务器设计与CherryStudio部署应用咨询：用一个文件基于FastMcp库本地编码搭建简单MCP服务，实现选择并上传一个音频文件然后自动运行streamableHTTP流式播放，所有功能可以在浏览器窗口测试[可上传URL或本地实际音频文件，列出所有上传音频文件，可选择播放]。在Cherry Studio可视环境做MCP treamableHTTP部署与运行[举例说明如何上传文件并进行指定文件的播放]。

树莓派5：充当streamable-http类型的MCP服务器为了尽量提高本地部署的小参量打折精度LLM获取数据时的幻觉问题，最近研究了下MCP。stdio和streamable-http方式都尝试了一下，在我的测试场景下都可行。鉴于streamable-http方式部署更为灵活，因此也尝试了一下用树莓派5充当streamable-http类型的MCP服务器。其实方法是通用的，跨平台完全可用。

FastMCP 高级特性之Background Tasks以异步的方式运行长耗时的操作，并跟踪进度。FastMCP 实现了 MCP 后台任务协议（SEP-1686），只需修改一个装饰器，就能为你的服务器提供一个可用于生产环境的分布式任务调度器。

FastMCP高级特性之Message Handling前面讲到，服务端可以发送消息。对于发送的消息，可以使用自定义消息处理器处理 MCP 消息、请求和通知。

FastMCP高级特性之Composition使用挂载和导入功能，将多个 FastMCP 服务器合并成一个更大的应用程序。随着您的 MCP 应用程序不断发展，您可能希望将工具、资源和提示组织到逻辑模块中，或者重用现有的服务器组件。FastMCP 通过两种方法支持组合：

FastMCP高级特性之Proxy Servers(代理服务)FastMCP的代理，就是给其他 MCP 服务器当个中间人，转发请求&转发响应。FastMCP 提供了强大的代理功能，使得一个 FastMCP 服务器实例可以作为另一个 MCP 服务器（该服务器可以是远程的、运行在不同传输协议上的，甚至可以是另一个 FastMCP 实例）的前端。

FastMCP之Prompts提示词就像给 AI 模型（比如 ChatGPT 这类）准备的「带填空的固定说法模板」—— 模板里的 “填空” 就是可替换的参数。当有人（客户端）要用到这个提示词时，流程是这样的：

FastMCP之Tools在MCP中，Tools是一个函数，它可以被用于执行动作或者访问外部系统。最简单的方法就是用@mcp.tool注解一个python的函数。

fastmcp 纳米AI 报错 uniq_id Unexpected keyword argument 多余参数报错在编写MCP服务，使用第三方工具调用，例如纳米AI来使用时，可能遇到如下报错。莫名其妙的多出来uniq_id或其他我们并未约定的参数。此时会触发参数多余报错，实测FastMCP 2.13.0.2版本是报错的。

14_FastMCP 2.x 中文文档之FastMCP服务端高级功能：MCP中间件详解通过中间件为您的 MCP 服务器添加横切关注功能，该中间件可以检查、修改和响应所有 MCP 请求和响应。

MonkeyKing_sunyuhua

什么是STDIO 模式，fastmcp 采用 STDIO我来分两部分给你讲清楚：⸻STDIO (Standard Input/Output) 模式指的是通过标准输入 (stdin) 和标准输出 (stdout) 来实现进程间通信的一种方式。 • stdin：程序从外部接收输入（比如命令行输入、管道输入）。 • stdout：程序把处理结果输出给外部（比如终端、管道的下一个程序）。 • stderr：专门输出错误信息。