stdio还是streamable-HTTPmcp-server-elasticsearch双协议选型终极指南【免费下载链接】mcp-server-elasticsearchElasticsearch Model Context Protocol (MCP) server项目地址: https://gitcode.com/gh_mirrors/mc/mcp-server-elasticsearch一文看懂 Elasticsearch MCP Server 的两种连接方式mcp-server-elasticsearch 是 Elastic 官方出品的 Elasticsearch MCP Server它基于 Model Context ProtocolMCP让你的 AI Agent 能用自然语言直接查询、分析和检索 Elasticsearch 索引全程无需编写任何自定义 API。这个项目的核心卖点之一是同时支持 stdio 和 streamable-HTTP 两种传输协议。选错协议轻则连接失败重则多租户场景下互相干扰。这篇指南帮你 5 分钟做出正确选择。⚠️ 提示该项目已被 Elastic Agent Builder 的 MCP 端点Elastic 9.2.0 及 Elasticsearch Serverless 可用取代当前仅接收关键安全更新。如果你是老集群用户本文依然实用。30 秒了解它能做什么连接成功后AI Agent 就获得了以下 5 个内置工具可以直接对话式操作你的集群工具作用list_indices列出所有索引get_mappings查看指定索引的字段映射search用 Query DSL 执行搜索esql执行 ES|QL 查询get_shards查看分片信息工具清单与协议实现分别位于src/servers/elasticsearch/base_tools.rs与src/protocol/目录想深挖细节可以直接读源码。两种协议一张表看懂对比维度stdiostreamable-HTTP通信方式客户端直接拉起服务端子进程走标准输入/输出独立 HTTP 服务默认监听 8080 端口典型场景Claude Desktop、Cursor、VS Code 等本地客户端Web 集成、远程部署、多客户端并发会话模型单进程、单会话支持有状态会话与并发客户端端点地址无进程间通信http://host:8080/mcp健康检查看容器日志GET /ping返回pong部署复杂度最低客户端拉起来即用需容器/服务器常驻运行⚠️ 另外注意SSEServer-Sent Events协议已废弃旧客户端若只认 SSE请优先迁移到 streamable-HTTP。选型决策3 个问题定答案问题 1你的 MCP 客户端运行在哪里客户端如 Claude Desktop、Cursor与服务端跑在同一台机器 → 选stdio最简单。客户端在浏览器或远程机器 → 选streamable-HTTPstdio 需要进程级拉起跨网络不可行。问题 2有几个客户端要同时连1 个 → stdio 足够。多个并发客户端共享一个服务 →streamable-HTTP它为有状态会话和并发而设计。问题 3需要健康检查和生产监控吗生产环境、K8s 部署 →streamable-HTTP。它的/_health路由下内置了/live与/ready探针端点实现见src/protocol/http.rs可直接对接 Kubernetes 存活/就绪检查。一句话总结本地单机用 stdio上生产、多客户端、要监控就用 streamable-HTTP。最快上手stdio 模式三步走第 1 步准备环境变量。两种协议配置完全一致核心是三个变量ES_URL你的集群地址如https://your-cluster.es.amazonaws.com:9200认证二选一ES_API_KEYAPI Key或ES_USERNAMEES_PASSWORD可选ES_SSL_SKIP_VERIFYtrue仅限开发测试环境跳过证书校验第 2 步用 Docker 以 stdio 模式启动注意最后的参数是stdiodocker run -i --rm \ -e ES_URL \ -e ES_API_KEY \ docker.elastic.co/mcp/elasticsearch \ stdio第 3 步在客户端配置里声明这个命令。以 Claude Desktop 为例在其配置文件中声明 command 为docker、参数同上、并把ES_URL和ES_API_KEY填入env字段即可完整 JSON 见 README.md 项目文档此处省略样板。启动逻辑在源码中一目了然src/lib.rs的run_stdio()负责拉起 stdio 服务src/cli.rs定义了stdio/http两个子命令。最快上手streamable-HTTP 模式三步走第 1 步同样的环境变量一个都不用改。第 2 步把启动参数换成http并映射端口docker run --rm \ -e ES_URL \ -e ES_API_KEY \ -p 8080:8080 \ docker.elastic.co/mcp/elasticsearch \ http第 3 步把 MCP 端点指向服务即可协议端点http://host:8080/mcp健康检查http://host:8080/ping小细节容器模式下服务默认绑定0.0.0.0:8080本地开发模式则绑定127.0.0.1:8080可用--address参数或HTTP_ADDRESS环境变量覆盖逻辑见src/lib.rs的run_http()。特殊情况客户端只支持 stdio 怎么办Claude Desktop 免费版等工具只认 stdio。这时可以用mcp-proxy做桥本地装一个 mcp-proxy以--transportstreamablehttp指向远程/mcp端点并把 API Key 放在Authorization请求头里。这样远程的 streamable-HTTP 服务就能被本地化给 stdio 客户端使用。连接失败按这个清单排查URL 对不对确认ES_URL可从容器所在环境访问凭据够不够API Key / 账号是否有对应索引权限网络通不通安全组、网络 ACL 是否放行了容器到集群的流量容器活没活docker ps看状态是否为Up再docker logs 容器ID查连接错误、认证错误。HTTP 模式下还有一招快查curl http://host:8080/ping收到pong说明服务本身健康问题大概率在集群侧。写在最后怎么选、看哪份文档新手本地试用→ stdio一条docker run命令搞定团队共享 / Web 集成 / 上生产→ streamable-HTTP配好健康检查再交付旧 SSE 客户端→ 直接迁移到 streamable-HTTP别修旧路。延伸阅读项目内文件README.md完整部署步骤与客户端配置样例src/protocol/http.rsstreamable-HTTP 路由与健康检查实现src/cli.rsCLI 参数与环境变量定义elastic-mcp.json5JSON5 格式配置示例选对协议让 AI Agent 与 Elasticsearch 的对话从此顺畅无阻。✨【免费下载链接】mcp-server-elasticsearchElasticsearch Model Context Protocol (MCP) server项目地址: https://gitcode.com/gh_mirrors/mc/mcp-server-elasticsearch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考