惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
爱范儿
爱范儿
WordPress大学
WordPress大学
博客园 - 三生石上(FineUI控件)
J
Java Code Geeks
Vercel News
Vercel News
aimingoo的专栏
aimingoo的专栏
T
Tailwind CSS Blog
罗磊的独立博客
B
Blog
博客园_首页
A
About on SuperTechFans
有赞技术团队
有赞技术团队
V
V2EX
U
Unit 42
I
InfoQ
IT之家
IT之家
博客园 - 司徒正美
阮一峰的网络日志
阮一峰的网络日志
博客园 - 叶小钗
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
Stack Overflow Blog
Stack Overflow Blog
The Cloudflare Blog
H
Help Net Security

博客园_首页

Plist 二进制格式 Milvus 和 PGVector,哪个更好? OpenClaw 已过时?在 VS Code 中运行 Hermes Agent! 第30篇文章:一个大三计科生的自白 Manim如何在数学公式中完美显示中文? Docker 部署 RocketMQ 5 并发编程核心概念辨析 C#事务处理最佳实践:别再让“主表存了、明细丢了”的破事发生 CLI 是什么?为什么大厂突然集体卷命令行? 【从0到1构建一个ClaudeAgent】协作-自主Agent UIImageView 设置图片不生效的原因排查 最小二乘问题详解20:无先验约束下的增量式SFM自由网平差 痞子衡嵌入式:大话双核i.MXRT1180之XIP应用里借助MU实现可靠Flash IAP的方法 AI Chat 封装, SemanticKerne.AiProvider.Unified 已发布 Windows下右键编辑js文件无法打开记事本——在注册表中使用环境变量 在后台服务中使用 Scoped 服务,为什么总是报错? H200 安装驱动并使用sglang启动模型 wireshark 抓包Trap上报告警内容 我用 AI 辅助开发了一系列小工具(2):图片压缩工具 [A Primer On MC and CC] 2.1 Memory Consistency 1 - 指令重排序和 SC 模型 Oracle数据库SCN推进技术详解与实践指南 玩转控件:封装个带图片的Label控件 Claude Code 4.7 真正该升级的不是模型,而是你的工作流 前端小白一句话,AI 帮我做了个颜值拉满的桌面媒体播放器。当代码不再是门槛,一句话编程就是现实。 5. WorkBuddy: 小龙虾的灵魂三件套,让你的小龙虾不只是工具 SQLite 分片方案实战:三种分片策略的深度对比 告别简陋 UI!一款基于 Fluent Design 和基于 WinUI 的开源免费、现代化的 Avalonia UI 控件库 关于二进制排列组合枚举的总结 AI开发-python-LangGraph框架(3-27-LangGraph从零实现大模型智能决策工作流) ElasticSearch主分片和副本分片概念详解
MCP 实战入门:用一个 demo 讲清 agent 如何调用工具
it排球君 · 2026-05-13 · via 博客园_首页

前言

本文主要内容是对mcp的实践

mcp 更像是一套统一插座:agent 想接监控、数据库、工单、知识库,不需要每个系统都重新写一套协议,只要大家都按 mcp 的方式暴露工具就行

本文笔者就结合一个最小 demo,拆一下 mcp server 和 agent 是怎么配合的,并聊聊 mcp 常见的几种传输模式:stdioSSE/HTTPwebsocket

先看代码

demo代码

.
├── agent.py
└── mcp_server.py
  • mcp_server.py:负责启动一个 MCP Server,并暴露一个工具:get_monitor_metrics

  • agent.py:负责启动 MCP client,通过 stdio 连接 MCP server,调用工具拿到监控指标,然后把指标交给大模型分析。

agent
  ↓ 调用 MCP Tool
MCP server
  ↓ 返回监控指标
agent
  ↓ 拼 prompt
LLM
  ↓ 输出分析结论

实践一下:

==================================================
Step1: 获取监控数据
==================================================
{
  "timestamp": 1770000000,
  "cpu_usage": 86.42,
  "memory_usage": 91.33,
  "pod_restart_count": 8,
  "api_error_rate": 12.5,
  "qps": 3200,
  "latency_ms": 1800
}

==================================================
Step2: Agent 分析
==================================================
当前系统存在异常风险。

主要问题包括:
1. CPU 使用率较高
2. 内存使用率较高
3. Pod 重启次数偏多
4. 接口错误率和延迟偏高

建议下一步优先查看 Pod 重启原因、应用错误日志、接口依赖服务状态以及最近发布记录。

MCP 的传输模式

  • stdio
  • SSE/HTTP
  • WebSocket

前面 demo 用的是 stdio

stdio 模式

stdio 是最适合本地工具的模式。它的通信方式很朴素:agent 启动 MCP Server 子进程,然后通过标准输入、标准输出通信

在本文 Demo 里,就是这段:

server_params = StdioServerParameters(
    command="python3",
    args=["mcp_server.py"]
)

async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool("get_monitor_metrics")

它的执行关系类似这样:

Agent 进程
  ├── 启动子进程:python3 mcp_server.py
  ├── stdin  写请求
  └── stdout 读响应

MCP Server 子进程
  ├── stdin  读请求
  └── stdout 写响应

stdio 的优点很明显:

  • 简单,不用开端口,不用配网关,不用考虑公网访问
  • 安全边界清楚,它只在本机进程之间通信,不天然暴露网络入口
  • 适合本地工具,比如本地文件检索、本地 Git 操作、本地数据库查询、本地脚本封装,都很适合 stdio

但它也有缺点:

  • 不适合多客户端共享,一个 agent 拉起一个子进程,更多是一对一的使用方式
  • 不适合远程服务,如果监控平台在远端、数据库在远端、多个 agent 都要复用同一个 MCP Server,stdio 就不太优雅
  • 生命周期跟 agent 绑定,agent 退出,子进程通常也就结束了

所以 stdio 的最佳场景是:

本地开发、本地工具、单 Agent 调用、追求简单和低暴露面

SSE/HTTP 模式

SSE/HTTP 更适合远程 MCP server。SSE 全称是 Server-Sent Events,可以理解成服务端通过 HTTP 连接持续向客户端推送事件

  • 客户端通过 HTTP 发起请求
  • 服务端通过 SSE 这类长连接返回消息流
  • MCP Server 可以作为一个独立 Web 服务长期运行

SSE/HTTP 的优点:

  • 适合远程部署,MCP Server 可以部署在服务器、K8s、内网服务里,agent 通过 URL 访问
  • 方便多客户端复用,多个 agent、多个用户,可以连接同一个 MCP Server
  • 更容易接入网关和鉴权,因为它是 HTTP 体系,可以结合 API Gateway、Ingress、OAuth、Token、TLS、审计日志等能力
  • 适合企业内部工具平台,比如把监控平台、CMDB、工单系统、知识库都封装成独立 MCP Server,然后统一挂到内网

缺点也很现实:

  • 部署复杂度更高,要考虑端口、域名、证书、鉴权、跨网络访问
  • 安全风险更高,一旦暴露 HTTP 服务,就要认真考虑权限控制。不要把能查生产数据、能执行命令、能操作工单的 MCP Server 裸奔到公网
  • 运维成本更高,服务可用性、限流、日志、监控、升级,都要考虑

SSE/HTTP 的最佳场景是:

远程工具服务、团队共享、企业内网、多 agent 复用、需要鉴权审计的生产场景

websocket 模式

websocket 是全双工长连接。和 SSE 相比,SSE 更偏服务端持续推给客户端,而 WebSocket 是双方都可以持续发消息

WebSocket 的优点:

  • 双向实时通信能力更强,客户端和服务端都能主动发送消息
  • 适合长时间会话,比如远程 IDE、交互式工具、实时状态订阅、多人协作场景。
  • 适合需要低延迟交互的场景,如果 MCP Tool 背后是一个持续运行的交互系统,websocket 会更自然。

但它的缺点也明显:

  • 连接状态管理更复杂,断线重连、心跳、连接数、会话恢复,都要处理
  • 网关和代理配置更麻烦,虽然现在很多网关都支持 websocket,但排查起来通常比普通 HTTP 更烦
  • 不一定是 MCP 最常用选择,在很多 MCP 实践里,stdio 和 HTTP/SSE 更常见

WebSocket 的最佳场景是:

长连接、低延迟、双向实时交互、会话型工具、远程协作类 MCP 服务

三种模式怎么选

传输模式 适合场景 优点 缺点
stdio 本地工具、本地开发、单 agent 调用 简单、安全、不暴露端口 不适合远程复用
SSE/HTTP 远程 MCP server、团队共享、企业内网 易部署到服务端、易接网关鉴权 运维和安全复杂度更高
websocket 实时交互、长连接、双向通信 低延迟、交互能力强 连接管理复杂

总结

本文通过一个监控 demo,演示了 MCP server、MCP tool、agent 协同工作

stdio 适合本地工具和快速验证,SSE/HTTP 适合远程服务和团队共享,websocket 适合长连接、低延迟、双向实时交互场景

联系我

  • 联系我,做深入的交流

至此,本文结束

在下才疏学浅,有撒汤漏水的,请各位不吝赐教...