Elasticsearch MCP Server

基本能力

产品定位

Elasticsearch MCP Server 是一个中间件服务，旨在通过 MCP 协议将 Elasticsearch 集群的功能暴露给各种 MCP 客户端（如 Claude Desktop、Cursor），使用户能够通过自然语言与 Elasticsearch 数据进行交互。

核心功能

• list_indices: 列出可用的 Elasticsearch 索引，支持正则表达式
• get_mappings: 获取特定 Elasticsearch 索引的字段映射
• search: 使用提供的查询 DSL 执行 Elasticsearch 搜索
• elasticsearch_health: 获取 Elasticsearch 集群健康状态，可选包括索引级详细信息
• create_index: 创建 Elasticsearch 索引，可选设置和映射
• create_mapping: 为 Elasticsearch 索引创建或更新映射结构
• bulk: 批量导入数据到 Elasticsearch 索引
• reindex: 将数据从源索引重新索引到目标索引，可选查询和脚本
• create_index_template: 创建或更新索引模板
• get_index_template: 获取索引模板信息
• delete_index_template: 删除索引模板

适用场景

• 需要快速查询和管理 Elasticsearch 数据的开发者和数据分析师
• 希望通过自然语言与 Elasticsearch 交互的非技术用户
• 需要批量操作 Elasticsearch 索引的场景
• 需要监控 Elasticsearch 集群健康状况的场景

工具列表

• MCP Inspector: 用于调试和分析请求的工具，可以启动代理服务器并监听端口

常见问题解答

• 必须提供 API key 或用户名和密码进行认证
• 需要配置 Elasticsearch 实例的 URL
• 支持自定义 CA 证书用于 SSL/TLS 连接

使用教程

使用依赖

• Elasticsearch 实例
• Elasticsearch 认证凭证（API key 或用户名/密码）
• MCP 客户端（如 Claude Desktop、Cursor）

安装教程

使用 NPM 包

1. 配置 MCP 客户端
2. 打开 MCP 客户端
3. 转到 Settings > Developer > MCP Servers

4. 点击 Edit Config 并添加以下配置： json { "mcpServers": { "elasticsearch-mcp": { "command": "npx", "args": [ "-y", "@awesome-ai/elasticsearch-mcp" ], "env": { "HOST": "your-elasticsearch-host", "API_KEY": "your-api-key" } } } }

5. 开始对话

6. 在 MCP 客户端中打开新对话
7. MCP 服务器应自动连接
8. 现在可以询问关于 Elasticsearch 数据的问题

本地开发

1. 使用正确的 Node.js 版本 bash nvm use

2. 安装依赖 bash npm install

3. 构建项目 bash npm run build

4. 在 Claude Desktop App 中本地运行

5. 配置 MCP 服务器如下： json { "mcpServers": { "elasticsearch-mcp": { "command": "node", "args": [ "/path/to/your/project/dist/index.js" ], "env": { "HOST": "your-elasticsearch-host", "API_KEY": "your-api-key" } } } }

调试方式

HOST=your-elasticsearch-url API_KEY=your-api-key npm run inspector

这将启动 MCP Inspector，允许调试和分析请求。您应该看到：

Starting MCP inspector...
Proxy server listening on port 3000

🔍 MCP Inspector is up and running at http://localhost:5173 🚀

许可证

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