技术

A2A学习 deepresearch梳理 mcp学习 SSE 和 WebSocket 是什么? AutoGen学习 Python ioc 从0到1构建一个db 上下文记忆 agentic chat 图数据库的一些考量 推理LLM梳理 Agent实践 LLM预训练 向量数据库的一些考量 fastapi+sqlalchemy进行项目开发 LLM微调实践 Python协程实现 Agent Functon Calling LLamaIndex入门 Multi-Agent探索 Python虚拟机 LangGraph工作流编排 Python实践 下一个平台Agent 激发LLM涌现——提示工程 LLM微调理论 大佬沉思 LLM外挂知识库 LLMOps 多模态LLM Python一些比较有意思的库 Transformers源码学习 LangChain源码学习 通用分布式计算引擎Ray Python并发 go依赖注入 go collection gc的基本原理 golang性能分析及优化 数据湖 高性能计算与存储 Linux2.1.13网络源代码学习 《大数据经典论文解读》 三驾马车学习 Spark 内存管理及调优 Yarn学习 从Spark部署模式开始讲源码分析 容器狂占内存资源怎么办? 多角度理解一致性 golang io使用及优化模式 Flink学习 c++学习 学习ebpf go设计哲学 ceph学习 学习mesh kvm虚拟化 学习MQ go编译器以及defer实现 学习go 为什么要有堆栈 汇编语言 计算机组成原理 运行时和库 Prometheus client mysql 事务 mysql 事务的隔离级别 mysql 索引 坏味道 学习分布式 学习网络 学习Linux go堆内存分配 golang 系统调用与阻塞处理 Goroutine 调度过程 重新认识cpu mosn有的没的 负载均衡泛谈 单元测试的新解读 《Redis核心技术与实现》笔记 《Prometheus监控实战》笔记 Prometheus 告警学习 calico源码分析 对容器云平台的理解 Prometheus 源码分析 并发的成本 基础设施优化 hashicorp raft源码学习 docker 架构 mosn细节 与微服务框架整合 Java动态代理 编程范式 并发通信模型 《网络是怎样连接的》笔记 go channel codereview gc分析 jvm 线程实现 go打包机制 go interface及反射 如何学习Kubernetes 《编译原理之美》笔记——后端部分 《编译原理之美》笔记——前端部分 Pilot MCP协议分析 go gc 内存管理玩法汇总 软件机制 istio流量管理 Pilot源码分析 golang io 学习Spring mosn源码浅析 MOSN简介 《datacenter as a computer》笔记 学习JVM Tomcat源码分析 Linux可观测性 学习存储 学计算 Gotty源码分析 kubernetes operator kaggle泰坦尼克问题实践 kubernetes扩缩容 神经网络模型优化 直觉上理解深度学习 如何学习机器学习 TIDB源码分析 什么是云原生 Alibaba Java诊断工具Arthas TIDB存储——TIKV 《Apache Kafka源码分析》——简介 netty中的线程池 guava cache 源码分析 Springboot 启动过程分析 Spring 创建Bean的年代变迁 Linux内存管理 自定义CNI IPAM 共识算法 spring redis 源码分析 kafka实践 spring kafka 源码分析 Linux进程调度 让kafka支持优先级队列 Codis源码分析 Redis源码分析 C语言学习 《趣谈Linux操作系统》笔记 docker和k8s安全访问机制 jvm crash分析 Prometheus 学习 Kubernetes监控 Kubernetes 控制器模型 容器日志采集 容器狂占资源怎么办? Kubernetes资源调度——scheduler 时序性数据库介绍及对比 influxdb入门 maven的基本概念 《Apache Kafka源码分析》——server Kubernetes类型系统 源码分析体会 《数据结构与算法之美》——算法新解 Kubernetes源码分析——controller mananger Kubernetes源码分析——apiserver Kubernetes源码分析——kubelet Kubernetes介绍 ansible学习 Kubernetes源码分析——从kubectl开始 jib源码分析之Step实现 线程排队 jib源码分析之细节 跨主机容器通信 jib源码分析及应用 为容器选择一个合适的entrypoint kubernetes yaml配置 《持续交付36讲》笔记 mybatis学习 程序猿应该知道的 无锁数据结构和算法 CNI——容器网络是如何打通的 为什么很多业务程序猿觉得数据结构和算法没用? 串一串一致性协议 当我在说PaaS时,我在说什么 《数据结构与算法之美》——数据结构笔记 PouchContainer技术分享体会 harbor学习 用groovy 来动态化你的代码 精简代码的利器——lombok 学习 《深入剖析kubernetes》笔记 编程语言那些事儿 rxjava3——背压 rxjava2——线程切换 spring cloud 初识 《深入拆解java 虚拟机》笔记 《how tomcat works》笔记 hystrix 学习 rxjava1——概念 Redis 学习 TIDB 学习 如何分发计算 Storm 学习 AQS1——论文学习 Unsafe Spark Stream 学习 linux vfs轮廓 《自己动手写docker》笔记 java8 实践 中本聪比特币白皮书 细读 区块链泛谈 比特币 大杂烩 总纲——如何学习分布式系统 hbase 泛谈 forkjoin 泛谈 看不见摸不着的cdn是啥 《jdk8 in action》笔记 程序猿视角看网络 bgp初识 calico学习 AQS——粗略的代码分析 我们能用反射做什么 web 跨域问题 《clean code》笔记 《Elasticsearch权威指南》笔记 mockito简介及源码分析 2017软件开发小结—— 从做功能到做系统 《Apache Kafka源码分析》——clients dns隐藏的一个坑 《mysql技术内幕》笔记 log4j学习 为什么netty比较难懂? 递归、回溯、动态规划 apollo client源码分析及看待面向对象设计 学习并发 docker运行java项目的常见问题 OpenTSDB 入门 spring事务小结 分布式事务 javascript应用在哪里 《netty in action》读书笔记 netty对http2协议的解析 ssl证书是什么东西 http那些事 苹果APNs推送框架pushy apple 推送那些事儿 编写java框架的几大利器 java内存模型和jvm内存布局 java exception Linux IO学习 netty内存管理 测试环境docker化实践 netty在框架中的使用套路 Nginx简单使用 《Linux内核设计的艺术》小结 Go并发机制及语言层工具 Linux网络源代码学习——数据包的发送与接收 《docker源码分析》小结 docker namespace和cgroup zookeeper三重奏 数据库的一些知识 Spark 泛谈 链式处理的那些套路 netty回顾 Thrift基本原理与实践(二) Thrift基本原理与实践(一) 回调 异步执行抽象——Executor与Future Docker0.1.0源码分析 java gc Jedis源码分析 深度学习泛谈 Linux网络命令操作 JTA与TCC 换个角度看待设计模式 Scala初识 向Hadoop学习NIO的使用 以新的角度看数据结构 并发控制相关的硬件与内核支持 systemd 简介 quartz 源码分析 基于docker搭建测试环境(二) spring aop 实现原理简述 自己动手写spring(八) 支持AOP 自己动手写spring(七) 类结构设计调整 分析log日志 自己动手写spring(六) 支持FactoryBean 自己动手写spring(九) 总结 自己动手写spring(五) bean的生命周期管理 自己动手写spring(四) 整合xml与注解方式 自己动手写spring(三) 支持注解方式 自己动手写spring(二) 创建一个bean工厂 自己动手写spring(一) 使用digester varnish 简单使用 关于docker image的那点事儿 基于docker搭建测试环境 分布式配置系统 JVM执行 git maven/ant/gradle/make使用 再看tcp kv系统 java nio的多线程扩展 《Concurrency Models》笔记 回头看Spring IOC IntelliJ IDEA使用 Java泛型 vagrant 使用 Go常用的一些库 Python初学 Goroutine 调度模型 虚拟网络 《程序员的自我修养》小结 Kubernetes存储 访问Kubernetes上的Service Kubernetes副本管理 Kubernetes pod 组件 Go基础 JVM类加载 硬币和扑克牌问题 LRU实现 virtualbox 使用 ThreadLocal小结 docker快速入门

架构

reward演进 大模型RLHF框架 rl框架 GPU与CUDA RL闲谈 MCTS与LLM rl与llm 从Transformer到DeepSeek bert rerank微调 大模型推理tips RAG向量检索与微调 dddfirework源码分析 RAG与知识图谱 大模型推理服务框架vLLM 大模型推理服务框架 模型服务化(未完成) 大模型Post-Training 大模型训练 大模型推理 从Attention到Transformer k8s设备管理 ddd从理念到代码 如何应用LLM 小鼠如何驾驭大象(LLM)? 多类型负载协调员Koordinator controller-runtime细节分析 finops学习 kubevela多集群 kubevela中cue的应用 基于k8s的工作流 kubevela源码分析 容器和CPU那些事儿 数据集管理fluid 应用管理平台kubevela karmada支持crd 多集群管理 AutoML和AutoDL 特征平台 实时训练 分布式链路追踪 K8S YAML 资源清单管理方案 tensorflow原理——python层分析 如何学习tensorflow 数据并行——allreduce 数据并行——ps 推荐系统embedding原理及实践 机器学习中的python调用c 机器学习训练框架概述 tensornet源码分析 大模型训练和推理 X的生成——特征工程 tvm tensorflow原理——core层分析 模型演变 《深度学习推荐系统实战》笔记 keras 和 Estimator tensorflow分布式训练 分布式训练的一些问题 基于Volcano的弹性训练 图神经网络 pytorch弹性分布式训练 从混部到统一调度 从RNN到Attention pytorch分布式训练 CNN 《动手学深度学习》笔记 pytorch与线性回归 多活 volcano特性源码分析 推理服务 kubebuilder 学习 mpi 学习pytorch client-go学习 提高gpu 利用率 GPU与容器的结合 GPU入门 AI云平台梳理 tensorflow学习 tf-operator源码分析 k8s批处理调度/Job调度 喜马拉雅容器化实践 Kubernetes 实践 学习rpc BFF openkruise学习 可观察性和监控系统 基于Kubernetes选主及应用 《许式伟的架构课》笔记 Admission Controller 与 Admission Webhook 发布平台系统设计 k8s水平扩缩容 Scheduler如何给Node打分 Scheduler扩展 深入controller openkruise cloneset学习 controller-runtime源码分析 pv与pvc实现 csi学习 client-go informer源码分析 kubelet 组件分析 调度实践 Pod是如何被创建出来的? 《软件设计之美》笔记 mecha 架构学习 Kubernetes events学习及应用 CRI——kubelet与容器引擎之间的接口 资源调度泛谈 业务系统设计原则 grpc学习 元编程 以应用为中心 istio学习 下一代微服务Service Mesh 《实现领域驱动设计》笔记 概率论 serverless 泛谈 《架构整洁之道》笔记 处理复杂性 那些年追过的并发 服务器端编程 网络通信协议 架构大杂烩 如何学习架构 《反应式设计模式》笔记 项目的演化特点 反应式架构摸索 函数式编程的设计模式 服务化 ddd反模式——CRUD的败笔 研发效能平台 重新看面向对象设计 业务系统设计的一些体会 函数式编程 《左耳听风》笔记 业务程序猿眼中的微服务管理 DDD实践——CQRS 项目隔离——案例研究 《编程的本质》笔记 系统故障排查汇总及教训 平台支持类系统的几个点 代码腾挪的艺术 abtest 系统设计汇总 《从0开始学架构》笔记 初级权限系统设计 领域驱动理念 现有上传协议分析 移动网络下的文件上传要注意的几个问题 推送系统的几个基本问题 做配置中心要想好的几个基本问题 不同层面的异步 分层那些事儿 性能问题分析 用户认证问题 资源的分配与回收——池 消息/任务队列

标签

k8s设备管理 多类型负载协调员Koordinator controller-runtime细节分析 finops学习 kubevela多集群 kubevela中cue的应用 基于k8s的工作流 kubevela源码分析 容器和CPU那些事儿 数据集管理fluid 应用管理平台kubevela karmada支持crd 多集群管理 K8S YAML 资源清单管理方案 从混部到统一调度 volcano特性源码分析 kubebuilder 学习 client-go学习 tf-operator源码分析 k8s批处理调度/Job调度 喜马拉雅容器化实践 Kubernetes 实践 openkruise学习 基于Kubernetes选主及应用 Admission Controller 与 Admission Webhook k8s水平扩缩容 Scheduler如何给Node打分 Scheduler扩展 深入controller openkruise cloneset学习 controller-runtime源码分析 pv与pvc实现 csi学习 client-go informer源码分析 kubelet 组件分析 调度实践 Pod是如何被创建出来的? Kubernetes events学习及应用 CRI——kubelet与容器引擎之间的接口 资源调度泛谈 如何学习Kubernetes 以应用为中心 kubernetes operator kubernetes扩缩容 serverless 泛谈 什么是云原生 自定义CNI IPAM docker和k8s安全访问机制 Kubernetes监控 Kubernetes 控制器模型 Kubernetes资源调度——scheduler Kubernetes类型系统 Kubernetes源码分析——controller mananger Kubernetes源码分析——apiserver Kubernetes源码分析——kubelet Kubernetes介绍 Kubernetes源码分析——从kubectl开始 kubernetes yaml配置 CNI——容器网络是如何打通的 当我在说PaaS时,我在说什么 《深入剖析kubernetes》笔记 Kubernetes存储 访问Kubernetes上的Service Kubernetes副本管理 Kubernetes pod 组件
A2A学习 reward演进 deepresearch梳理 mcp学习 大模型RLHF框架 rl框架 GPU与CUDA RL闲谈 MCTS与LLM rl与llm AutoGen学习 从Transformer到DeepSeek 上下文记忆 agentic chat bert rerank微调 大模型推理tips 推理LLM梳理 Agent实践 LLM预训练 RAG向量检索与微调 LLM微调实践 RAG与知识图谱 大模型推理服务框架vLLM Agent Functon Calling LLamaIndex入门 Multi-Agent探索 LangGraph工作流编排 大模型推理服务框架 模型服务化(未完成) 大模型Post-Training 大模型训练 大模型推理 从Attention到Transformer 下一个平台Agent 激发LLM涌现——提示工程 LLM微调理论 大佬沉思 LLM外挂知识库 LLMOps 多模态LLM Transformers源码学习 LangChain源码学习 如何应用LLM 小鼠如何驾驭大象(LLM)? AutoML和AutoDL 特征平台 实时训练 tensorflow原理——python层分析 如何学习tensorflow 数据并行——allreduce 数据并行——ps 推荐系统embedding原理及实践 机器学习中的python调用c 机器学习训练框架概述 tensornet源码分析 大模型训练和推理 X的生成——特征工程 tvm tensorflow原理——core层分析 模型演变 《深度学习推荐系统实战》笔记 keras 和 Estimator tensorflow分布式训练 分布式训练的一些问题 基于Volcano的弹性训练 图神经网络 pytorch弹性分布式训练 从RNN到Attention pytorch分布式训练 CNN 《动手学深度学习》笔记 pytorch与线性回归 推理服务 mpi 学习pytorch 提高gpu 利用率 GPU与容器的结合 GPU入门 AI云平台梳理 tensorflow学习 kaggle泰坦尼克问题实践 神经网络模型优化 概率论 直觉上理解深度学习 如何学习机器学习 深度学习泛谈

mcp学习

2025年04月06日

简介

当前的 AI Agent,无论是和各种 Tools(各类业务服务接口)交互,还是和各类 Memory(各类存储服务接口)交互,亦或是和各类 LLMs(各类大语言模型)交互,都是通过 HTTP 协议的,除了 LLM 因为基本都遵循 OpenAI 范式以外,和其他的 Tools 和 Memory 交互都需要逐一了解它们的返回格式进行解析和适配。

MCP 的主要目的是如何让 AI 应用快速而灵活地扩展功能,这里的“扩展”可以是插件、工具或者其它资源。手段是标准化 LLM 应用如何连接到不同的系统。从本质上讲:当你想为一个你不能控制的 agent 引入工具时,MCP 就会派上用场。在 MCP 出现之前,开发者必须编写代码,并通过 API 将 AI 工具与外部系统连接,这意味着每个集成都需要预先编码。MCP 的核心价值在于:让用户为不可控的 Agent 添加工具。例如在使用 Claude Desktop、Cursor 等应用时,普通用户无法修改底层 Agent 的代码,但通过 MCP 协议就能为其扩展新工具。非开发者通过 MCP 定制个性化 Agent 将成为可能。

从LLM的角度看,它标准化了应用程序如何为 LLM 提供上下文。LLM侧是比较清爽简单的,所有“变”和“不一样”的东西都放在这个MCP Server这里,类似于一个适配于LLM的Adapter。在此之上就是各种Agent工具,随着Agent和应用不断复杂,是一定需要单独抽一层这样的Adapter出来的。相对于LLM应用直连外部资源,这里主要多了一个中间层(MCP Server),以及连接这个中间层的(MCP Client),理解了这两个,你就理解了MCP。

商业价值

  1. 传统的做法其实是xxx+AI,也就是各个业务系统融入一些AI能力;有了MCP,是可以构建AI+xxx,把AI作为新业务的中心,通过将业务系统的api封装后提供MCP接入能力,让各类新业务按需调用,这样就是新的重构了。
  2. 现在很多事情需要我们通过 APP 自己去操作 UI,比如出去玩要自己通过不同的 APP 找攻略、订机票、记花销等等,将来可能很多事情都可以通过 AI 结合 MCP 串起来,商业公司也有一种可能会演化为纯粹提供信息和数据服务的形态来提供价值,不再依赖 APP 本身了。 与 AI 对话的交互可能是将来统一甚至唯一的入口,出门有手表之类的穿戴设备就可以了,不再强依赖一个像手机一样移动的屏幕。 PS: 不过这些商业价值,主要靠remote mcp server 来推动。

mcp 协议

协议specification

MCP(Model Context Protocol,模型上下文协议)旨在实现大型语言模型(LLM)与外部数据源和工具的无缝集成,目标是成为 AI 领域的“HTTP 协议”,推动 LLM 应用的标准化和去中心化。

  1. MCP 遵循 CS 架构(client-server),具体包含的组件如下:
    1. Host 主机:发起连接 LLM 的应用程序,例如 Claude for Desktop 或其他的 AI 应用。
    2. MCP Client 客户端:运行在主机里的客户端,与 MCP Server 服务器保持 1:1 连接,负责协议通信。
    3. MCP Server 服务器:负责向客户端提供 资源、提示 和 工具 的服务器。
  2. Base Protocol: Core JSON-RPC message types
  3. Lifecycle Management: Connection initialization, capability negotiation, and session control
  4. Server Features: Resources, prompts, and tools exposed by servers

    1. 资源,表示 MCP 服务器想要向客户端提供的任何类型的数据。包括:文件内容、数据库记录、API 响应、实时系统数据、截图和图片、日志文件等更多内容。每个资源由唯一的 URI 标识,并且可以包含文本或二进制数据。应用可以在交互过程中让模型选择要不要用这些数据,也可以让用户从“资源列表”里手动挑选注入对话。
       {
           uri: string;           // Unique identifier for the resource
           name: string;          // Human-readable name
           description?: string;  // Optional description
           mimeType?: string;     // Optional MIME type
       }
      
    2. 提示,是预定义的模板。这是人为触发的提示文本,在编辑器里,可能以 / 命令 或模板形式出现。当用户想使用这个提示时,可以直接注入给模型。
       {
           name: string;              // Unique identifier for the prompt
           description?: string;      // Human-readable description
           arguments?: [              // Optional list of arguments
               {
               name: string;          // Argument identifier
               description?: string;  // Argument description
               required?: boolean;    // Whether argument is required
               }
           ]
       }
      
    3. 工具,允许服务器公开可由客户端调用并由 LLM 用来执行操作的可执行函数。工具的关键方面包括:
      1. 发现 tools/list:客户端可以通过端点列出可用的工具
      2. 调用:使用端点调用工具 tools/call,服务器执行请求的操作并返回结果
       {
           name: string;          // Unique identifier for the tool
           description?: string;  // Human-readable description
           inputSchema: {         // JSON Schema for the tool's parameters
               type: "object",
               properties: { ... }  // Tool-specific parameters
           }
       }
      

      作者:这些原语背后都有各自适用场景。工具是“模型自己想用时随时可调”,资源更像“额外可选上下文”,提示则是“用户显式想插入的预设文本”。我们希望把这些都抽象出来,给应用开发者提供更多可控的用户体验,而不是所有事情都丢给模型自由调用。

  5. Client Features: Sampling and root directory lists provided by clients
  6. Utilities: Cross-cutting concerns like logging and argument completion

作者:很多人会问,MCP 和 OpenAPI 对比如何?或者说它们会不会冲突?OpenAPI 在传统 RESTful 领域很成熟,但如果你想针对 AI 场景,构建那种可多轮调用、可调取不同数据上下文的扩展,OpenAPI 可能太细粒度了。它并没有“提示”“资源”“工具”的高级抽象。我们更希望为 AI 应用提供专门的协议能力。

协议层/消息格式

MCP 协议使用 JSON-RPC 2.0 作为消息传输格式,JSON-RPC 2.0是一种轻量级的、用于远程过程调用(RPC)的消息交换协议,使用JSON作为数据格式。注意:它不是一个底层通信协议,只是一个应用层的消息格式标准。形象的说,就像两个人需要交换包裹,它规定了包裹应该如何打包、内部如何分区、如何贴标签等,但它不规定包裹如何运送。包含以下三种类型的 JSON-RPC 消息:

  1. Request 请求:
     {
         "jsonrpc": "2.0",
         "id": 1,                            // 请求 ID(数字或字符串)
         "method": "string",                 // 方法名
         "params": {}                        // 可选,参数对象
     }
     比如
     {
         "jsonrpc": "2.0",               // 协议版本,固定为 "2.0"
         "method": "calculate",          // 要调用的方法名
         "params": {                     // 方法参数,可以是对象或数组
             "expression": "5+3"
         },
         "id": 1                         // 请求标识符,用于匹配响应
     }
  2. Response 响应:
     {
         "jsonrpc": "2.0",
         "id": 1,                            // 对应请求的 ID
         "result": {},                       // 可选,成功结果
         "error": {                          // 可选,错误信息
             "code": 123,
             "message": "错误描述",
             "data": {}                        // 可选,附加数据
         }
     }
     比如
     {
         "jsonrpc": "2.0", // 协议版本
         "result": 8,      // 调用结果
         "id": 1           // 对应请求的标识符
     }
  3. Notification通知(单向,无需响应):
     {
         "jsonrpc": "2.0",
         "method": "string",                 // 通知方法名
         "params": {}                        // 可选,参数对象
     }

传输层/传输方式

深入MCP Remote模式:两大基础协议及工作原理,一步步教你弄懂规定了消息的标准,再选择一种传输方式。MCP 协议内置了两种标准传输方式:标准输入/输出(stdio) 和 Server-Sent Events(SSE) 。所有传输均采用JSON-RPC 2.0进行消息交换

  1. stdio 传输通过 标准输入输出流 实现客户端与服务器之间的通信,适用于本地集成与命令行工具。
    1. 客户端 (Cline) 将 MCP 服务器作为子进程启动
    2. 通信通过进程流进行:客户端写入服务器的 STDIN,服务器通过 STDOUT 响应
    3. 每条消息以换行符分隔
  2. SSE,通过 HTTP 协议实现服务器到客户端的实时单向数据推送,结合 HTTP POST 用于客户端到服务器的消息发送。client 与server 运行在不同的node上。

    1. 建立连接:客户端首先请求建立 SSE 连接(/sse),服务端“同意”,然后生成并推送唯一的Session ID。
    2. 请求发送:客户端通过 HTTP POST (/messages) 发送 JSON-RPC2.0 请求(请求中会带有Session ID 和Request ID信息)。
    3. 请求接收确认:服务端接收请求后立即返回 202 (Accepted) 状态码,表示已接受请求。
    4. 异步处理:服务端应用框架会自动处理请求,根据请求中的参数,决定调用某个工具或资源。
    5. 结果推送:处理完成后,服务端通过 SSE 通道推送 JSON-RPC2.0 响应,其中带有对应的Request ID。
    6. 结果匹配:客户端的SSE连接侦听接收到数据流后,会根据Request ID 将接收到的响应与之前的请求匹配。
    7. 重复处理:循环2-6这个过程。这里面包含一个MCP的初始化过程。
    8. 连接断开:在客户端完成所有请求后,可以选择断开SSE连接,会话结束。
  3. Streamble HTTP:通过 HTTP 进行通信,支持流式传输。(协议版本 2025-03-26 开始支持,用于替代 SSE)

其它

  1. 连接管理:SSE 连接是单向的(服务器到客户端),通常通过定期发送心跳消息(keep-alive)保持活跃。如果连接断开,客户端可以重新发起 SSE 请求重建连接。
  2. 数据格式。SSE 消息遵循 event:\ndata:\n\n 的格式。 MCP 使用 JSON-RPC 2.0 协议封装消息,确保请求和响应的结构化处理

现在,你应该可以理解,如果使用官方的低层SDK来开发MCP Server,为什么Server启动代码大概长这样:

mcp = FastMCP("example")
mcp_server = mcp._mcp_server  # noqa: WPS437
app = SseServerTransport("/messages/")
async def handle_sse(request: Request) -> None:
    async with app.connect_sse(request.scope,request.receive,  request._send, ) as (read_stream, write_stream):
        await mcp_server.run(
            read_stream,
            write_stream,
            mcp_server.create_initialization_options(),
        )
starlette_app = Starlette(
    debug=True,
    routes=[
        Route("/sse", endpoint=handle_sse),
        Mount("/messages/", app=sse.handle_post_message),
    ],
)

为什么需要SSE?单一的HTTP Post方式存在的不足

  1. 单一的请求/响应模式下,客户端必须等待服务端处理完成,这适合快速响应的API,但不擅长应对长时间运行的任务。
  2. 无法服务端推送:缺乏双向通信的能力。正如上面的场景,如果你的MCP Server运行一个长时间的任务,你可能需要定期的向客户端报告处理进度或者中间结果,而简单HTTP Post无法做到。
  3. 短连接:无法应对对话式会话的需求。在实际应用场景中,你的客户端AI应用可能会在一次会话中多次频繁地与MCP Server对话,来访问其中的资源或工具。这种对话式的交互需要保持会话状态和连接,这需要建立长连接的会话。
  4. 流式输出的需求。AI Agent的应用场景中,有时候也需要工具调用做流式的输出,这也需要MCP Server的支持。

由于SSE是一种单向通信的模式,所以它需要配合HTTP Post来实现客户端与服务端的双向通信。严格的说,这是一种HTTP Post(客户端->服务端) + HTTP SSE(服务端->客户端)的伪双工通信模式。一个HTTP Post通道, 一个HTTP SSE通道,两个通道通过session_id来关联,而请求与响应则通过消息中的id来对应。

详解 MCP 传输机制 未细读。

持续演进中

尽管HTTP with SSE的模式带来了很多优点,但也缺点

  1. 不支持可恢复性(Resumability),连接断开后,客户端必须重新开始整个会话。
  2. 服务器需要维持长期连接(High Availability Requirement):服务器必须保持高可用性,以支持持续的 SSE 连接。
  3. SSE 仅支持服务器 → 客户端消息,无法灵活进行双向通信。

所以在最新的MCP标准(2025-03-26版)中,对目前的传输方式做了调整,改名为Streamable HTTP。其主要变动在于允许在MCP Server端根据自身需要来选择:你可以选择简单的无状态模式,也可以按需选择支持目前的HTTP with SSE模式。这给予了开发者更大的选择权,具体包括:

  1. 移除了专门的/sse端点,所有通信都通过单一/message端点进行。
  2. 任何 HTTP POST 请求都可被服务器按需升级为 SSE 流(不再强制);客户端也可通过GET 请求初始化 SSE 流(目前模式)。简单来说,原来的 MCP 传输方式就像是你和客服通话时必须一直保持在线(SSE 需要长连接),而新的方式更像是你随时可以发消息,然后等回复(普通 HTTP 请求,但可以流式传输)。
  3. 服务器支持完全无状态部署。 Streamable HTTP 意味着任何请求方(甚至就是一段简单的 HTTP Request 代码),都可以像请求标准 HTTP API 的方式一样和 MCP Server 交互。换句话说,当可以使用标准 HTTP API 的方式和 MCP Server 交互后,是不是就不存在所谓的 MCP Client了?

mcp server

MCP 也是一种 API。MCP 服务器本质是通过 MCP 协议提供标准化接口的服务端(PS:将其它所有api封装为mcp对外提供)。会将其功能公开为具有语义描述的“工具”。每个工具都是自我描述的,并包含有关工具功能、每个参数的含义、预期输出以及约束和限制的信息。假设你更改了服务器中某个工具所需的参数数量。使用 MCP,你不会破坏使用服务器的任何客户端。PS: 与api区别是多了一个 description 字段。这个字段是用来描述这个 API 的功能,以及如何使用的。以让其它 AI Agent 能够更好地调用。

MCP Server有哪些“服务”?

  1. Tools:提供给LLM应用特别是Agent使用的工具。
  2. Resoures:提供给LLM应用一些额外的结构化数据。资源通常提供数据,而不是执行动作,与工具不同
  3. Prompts:提供给LLM应用的一些Prompt模板。比如你的应用是一个Chatbot,可以从MCP Server中取出这些模板,让使用者选择使用。

MCP Server如何启动?

  1. 本地模式下,在LLM应用中配置启动命令后,会自动启动MCP Server
  2. 不同的MCP Server可能有不同的启动命令,注意查看MCP Server说明书
  3. 有的MCP Server需要先安装依赖;有的通过npx/uvx运行的MCP server,则会自动下载缓存并临时运行。

mcp server 列表

本地模式

本地模式下MCP Server可以部署在LLM应用本机,Client与Server是一对一的关系。如果需要连接多个MCP Server,需要自行维护多个Session。client 在本地运行 server 服务作为子进程,通过标准输入/输出建立通信,使用 JSON-RPC 2.0 消息格式。PS: 都启动subprocess 不一对一也不行了。

  1. 在LLM应用中配置启动命令后,会自动启动MCP Server,MCP Server启动后的物理形式是一个独立的进程。
  2. MCP Server与客户端应用间通过stdio/stdout(标准输入输出)的进程间通信进行消息交换。这种方式你肯定见过,比如:cat file.txt | grep "error" | sort > result.txt,还有类似k8s的cni 插件
  3. 服务器再连接到互联网上的各种API和服务。

Local MCP Server虽然简单易用,但在企业级应用中面临诸多挑战:

  1. 本地环境依赖,对用户本地环境有依赖,比如需要安装 python或docker 等执行环境来运行MCP Server,对非技术用户不友好
  2. 安全风险,企业不可能将敏感数据库凭证、API密钥或其他关键访问令牌配置给每个员工的本地环境。这不仅违反最小权限原则,还大大增加了凭证泄露的风险。
  3. 一致性问题,当多个用户需要访问相同的企业资源时,难以保证配置和权限的一致性,容易导致数据不一致或权限混乱。
  4. 维护成本,为每个用户设备部署和维护MCP Server需要大量IT资源,版本更新、安全补丁和配置变更都需要在每台设备上单独执行。

remote模式

Remote MCP Server则是部署在云端的MCP服务器,供多个 client 调用,用户可以通过互联网访问。在这种模式下,MCP客户端可以是更广泛的网页应用或移动应用,它们通过HTTP协议与远程MCP服务器通信。Remote MCP Server通常集成了认证授权、状态管理、数据库访问等企业级功能,能够为多用户提供服务。

mcp网关(未完成)

从理论到落地:MCP 实战解锁 AI 应用架构新范式

  1. 现存的传统业务能快速转成 MCP Server 吗?能 0 代码改动的转换吗?前文说的mcp server 都是基于各语言的 MCP SDK 开发的程序或服务。有没有更自动化一点的?
  2. MCP Server 会很多,如何统一管理?有自己开发的 MCP Server,有三方的 MCP Server,还有大量通过某种神秘机制将传统业务转换而来的 MCP Server。这些都应该有一个类似 MCP Hub 或 MCP 市场的东西统一管理起来,方便 MCP Client 去使用。
  3. 企业级 AI 应用中,身份认证、数据权限、安全这些如何做?在企业级的应用中,无论哪种协议,哪种架构,哪种业务。身份认证、数据权限、安全防护这些问题都是永远绕不开的。那么在 MCP 这种协同方式下如何实现。这里有两个层面的权限管控:
    1. Client 有权使用哪些 MCP Server。有权使用某 MCP Server 里的哪些 MCP Tool。
    2. Client 通过 MCP Tool 有权获取到哪些数据。

对客户端的影响

  1. mcp tool的描述会加入到 选择tool的llm 的system prompt中,这个system prompt安全性如何保证?针对MCP的常见攻击手法
  2. 系统提示词写的不好,如何方便的快速调试?能不能实时生效?
  3. 如果 MCP Server 很多,那么系统提示词会非常长,岂不是很消耗 Token?如何缩小或精确 MCP Server 和 MCP Tool 的范围?

网关最擅长做的事情就是协议转换,在 API Registry 中新增[Server Name]-mcp-tools.json 命名规范的配置文件,在配置文件中使用 MCP 规范对现存业务的接口进行描述。通过云原生 API 网关(MCP 网关),MCP Client 侧自动发现由传统服务转换来的 MCP Server。云原生 API 网关作为 MCP 网关,可以通过插件机制,改写或增加 Request Header 的值,将 Header 的值透传下去,然后在服务内部进一步做数据权限管控。

mcp client

当一段代码,一个 Agent,一个客户端,基于 MCP 的规范去使用、去调用 MCP Server 里的 MCP Tool 时,它就是 MCP Client。

从代码上讲,MCP Client是由客户端LLM app使用Client SDK创建并维护的一个Server会话,就像你在程序中维护一个数据库的Connection一样。一般长这样:

server_params = StdioServerParameters(
    command="python",
    args=["./test_mcp_server.py"],
    env=None
)
async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write, sampling_callback=None) as session:
        await session.initialize()
        # 查看Server的Tools
        tools = await session.list_tools()
        # 接下来拿着tools 构造openai chat api
        ...
        # 根据llm的结果调用工具
        result = await session.call_tool("calculate", {"expression": "188*23-34"})
        print(result.content)

langchain 或llamaindex 稍微包了一下,输入 StdioServerParameters 输出client,client 与自家的Tool定义无法集成。此外,还提供 MultiServerMCPClient来封装多个 mcp server。

mcp_client = MultiServerMCPClient(
    {
        "tavily": {
            "command": "npx",
            "args": ["-y", "@mcptools/mcp-tavily"],
            "env": {**os.environ} # 传递环境变量给MCP工具
        }
    }
)
async with mcp_client ) as client:
    # 创建ReAct风格的agent
    agent = create_react_agent(model, client.get_tools())

对于openai-python-agent 来说,直接支持mcp概念,所以跟更自然一点。

async def main():
    # 1. 创建MCP Server实例
    search_server = MCPServerStdio(
        params={
            "command": "npx",
            "args": ["-y", "@mcptools/mcp-tavily"],
            "env": {**os.environ}
        }
    )
    await search_server.connect()

    # 2. 创建Agent并集成MCP Server
    agent = Agent(
        name="助手Agent",
        instructions="你是一个具有网页搜索能力的助手,必要时使用搜索工具获取信息。",
        mcp_servers=[search_server], # 将MCP Server列表传入Agent
    )

源码分析

FastMCP是在低层MCP SDK上封装的简易框架,隐藏了细节。这块等有需求时得进一步深入源码学习。

mcp server示例

from mcp.server.fastmcp import FastMCP
# 初始化了一个 MCP 服务器对象,后续的功能将基于这个对象注册和运行
mcp = FastMCP("演示")

# 将 add 函数注册为 MCP 服务器的一个“工具”(Tool)
@mcp.tool()
def add(a:int, b:int)-> int:
    """
    Adds two numbers.
    """
    return a + b
# 定义一个资源函数 get_greeting
@mcp.resource("greeting://{name}")
def get_greeting(name:str)-> str:
    """
    Returns a greeting message.
    """
    return f"Hello, {name}!"
if __name__ == "__main__":
    # transport='stdio': 指定通信方式为标准输入输出(stdio)。这意味着服务器通过命令行(终端)的输入和输出与客户端通信,而不是通过网络(如 HTTP 或 WebSocket)。
    mcp.run(transport='stdio') # 调用 FastMCP 实例的 run 方法,开始运行服务器

mcp server自身实现

100行代码讲透MCP原理python 原生简单实现

from fastapi import FastAPI, Request
import uuid
from sse_starlette.sse import EventSourceResponse
from pydantic import BaseModel
import json

app = FastAPI()
mcpHub = {}

class McpRequest(BaseModel):
    id: Optional[int] = None
    jsonrpc: str
    method: str
    params: Optional[dict] = None

class MCPServer:
    def __init__(self):
      self.queue = asyncio.Queue()
        
    async def reader(self):
        while True:
            event = await self.queue.get()
            yield event

    async def request(self, payload: McpRequest):
        if payload.method == "initialize":
            await self.queue.put({"event": "message", "data": ..})
        elif payload.method == "tools/list": # 对应client_session.list_tools?
            ...

@app.get("/sse")
async def sse():
    client_id = str(uuid.uuid4())
    mcp = MCPServer()
    mcpHub[client_id] = mcp
    await mcp.queue.put({"event": "endpoint", "data": f"/message?client_id={client_id}"})
    return EventSourceResponse(mcp.reader())
    
@app.post("/message")
async def message(request: Request, payload: McpRequest):
    client_id = request.query_params.get("client_id")
    if client_id not in mcpHub:
        return "no client"
    await mcpHub[client_id].request(payload)
    return "ok"

完整实现 PS: 实现mcp gateway 可以参考。

from fastapi import FastAPI, Request
from sse_starlette.sse import EventSourceResponse
import asyncio
import json
import uuid
from pydantic import BaseModel
from typing import Optional
import uvicorn
import inspect
app = FastAPI()
mcpHub = {}
class McpRequest(BaseModel):
    id: Optional[int] = None
    jsonrpc: str
    method: str
    params: Optional[dict] = None
class MCPServer:
    def __init__(self, name, message_path, tools):
        self.queue = asyncio.Queue()
        self.client_id = str(uuid.uuid4())
        self.message_path = message_path
        self.info = {
            "protocolVersion": "2024-11-05",
            "capabilities": {
                "experimental": {},
                "tools": {
                    "listChanged": False
                }
            },
            "serverInfo": {
                "name": name,
                "version": "1.6.0"
            }
        }
        self.tools = tools
    def list_tool(self):
        result = []
        for tool in self.tools:
            toolInfo = {
                "name": tool.__name__,
                "description": tool.__doc__,
                "inputSchema": {"type": "object","properties":{}},
            }
            for name, param in inspect.signature(tool).parameters.items():
                toolInfo["inputSchema"]["properties"][name] = {
                    "title": name,
                    "type": "string",
                }
            result.append(toolInfo)
        return result
    async def reader(self):
        while True:
            event = await self.queue.get()
            yield event
    @staticmethod
    def response(result, id):
        message = {
            "jsonrpc": "2.0",
            "result": result,
        }
        if id is not None:
            message["id"] = id
        return json.dumps(message)
    async def request(self, req: McpRequest):
        if req.method == "initialize":
            await self.queue.put({"event": "message", "data": self.response(self.info, req.id)})
        elif req.method == "tools/list":
            await self.queue.put({"event": "message", "data": self.response({"tools": self.list_tool()}, req.id)})
        elif req.method == "tools/call":
            for tool in self.tools:
                if tool.__name__ == req.params.get("name"):
                    result = await tool(**req.params["arguments"])
                    await self.queue.put({"event": "message", "data": self.response({"content": result, "isError": False}, req.id)})
                    break
async def test(state=None):
    """
    description
    """
    result = f"hi {state}"
    await asyncio.sleep(1)
    result += "!"
    return result
@app.get("/receive_test")
async def receive_test():
    mcp = MCPServer(name="mcp-test",message_path="/send_test", tools=[test])
    mcpHub[mcp.client_id] = mcp
    await mcp.queue.put({"event": "endpoint", "data": f"{mcp.message_path}?client_id={mcp.client_id}"})
    return EventSourceResponse(mcp.reader())
@app.post("/send_test")
async def send_test(request: Request, payload: McpRequest):
    client_id = request.query_params.get("client_id")
    if client_id not in mcpHub:
        return "no client"
    await mcpHub[client_id].request(payload)
    return "ok"
if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8001)

其它

8种主流Agent框架与MCP的集成 思路两种

  1. 原生支持mcp,当然底层还是tool
  2. 将mcp 视为tool

一些比较有意思的mcp 在 Kubernetes 和 AI 之间搭一座桥:MCP-K8s


Related Issues not found

Please contact @qiankunli to initialize the comment