Elasticsearch MCP 服务器

基本能力

产品定位

Elasticsearch MCP 服务器是一个基于 Model Context Protocol (MCP) 的 Elasticsearch 工具服务器，主要用于提供 Elasticsearch 的索引查询、映射获取、搜索等功能。

核心功能

1. list_indices - 显示 ES 集群的所有索引
2. get_mappings - 返回指定索引的字段映射信息
3. search - 在指定索引中执行搜索查询，支持高亮显示
4. get_cluster_health - 获取 ES 集群的健康状态信息
5. get_cluster_stats - 获取 ES 集群的运行状态统计信息

适用场景

1. 与 Claude Desktop 等客户端集成，提供 Elasticsearch 数据访问功能
2. 作为独立服务启动，提供 Elasticsearch 查询和搜索功能
3. 开发环境中用于测试和验证 Elasticsearch 集群的状态和性能

工具列表

1. list_indices - 显示 ES 集群的所有索引
2. get_mappings - 返回指定索引的字段映射信息
3. search - 在指定索引中执行搜索查询，支持高亮显示
4. get_cluster_health - 获取 ES 集群的健康状态信息
5. get_cluster_stats - 获取 ES 集群的运行状态统计信息

常见问题解答

1. 本项目同时支持 Elasticsearch 7 和 8 版本的 API
2. 服务器默认使用 stdio 传输模式，适合与 Claude Desktop 等客户端集成
3. SSE 模式适合作为独立服务启动

使用教程

使用依赖

无特殊依赖，直接安装即可。

安装教程

# 从PyPI安装
pip install es-mcp-server

# 或从源码安装
pip install .

# 安装开发依赖
pip install ".[dev]"

启动服务器

stdio 模式 (与 Claude Desktop 等客户端集成)

# 使用默认配置
uvx es-mcp-server

# 自定义 ES 连接
uvx es-mcp-server --host 192.168.0.13 --port 9200 --es-version 8

SSE 模式 (Web 服务器模式)

# 启动 SSE 服务器
uvx es-mcp-server --transport sse --host 192.168.0.13 --port 9200

调试方式

# 运行单元测试以验证功能
pytest

注意事项

• 本项目同时支持 Elasticsearch 7 和 8 版本的 API
• 服务器默认使用 stdio 传输模式，适合与 Claude Desktop 等客户端集成
• SSE 模式适合作为独立服务启动

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。