Elasticsearch MCP Server
2025.04.15
109
JavaScript数据库管理自然语言查询数据库
Elasticsearch MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，允许用户通过自然语言对话与 Elasticsearch 数据进行交互。它提供了多种工具来查询和管理 Elasticsearch 索引，适用于需要快速访问和分析 Elasticsearch 数据的场景。
View on GitHub
Overview
基本能力
产品定位
Elasticsearch MCP Server 是一个连接 MCP 客户端（如 Claude Desktop）与 Elasticsearch 数据的桥梁，使用户能够通过自然语言查询和操作 Elasticsearch 索引。
核心功能
- 列出索引：列出所有可用的 Elasticsearch 索引。
- 获取映射：获取特定 Elasticsearch 索引的字段映射。
- 执行搜索：使用提供的查询 DSL 执行 Elasticsearch 搜索。
- 获取分片信息：获取所有或特定索引的分片信息。
适用场景
- 快速查询 Elasticsearch 数据。
- 分析索引结构和字段映射。
- 通过自然语言进行复杂查询。
工具列表
list_indices：列出所有可用的 Elasticsearch 索引。get_mappings：获取特定 Elasticsearch 索引的字段映射。search：使用提供的查询 DSL 执行 Elasticsearch 搜索。get_shards：获取所有或特定索引的分片信息。
常见问题解答
- 确保 MCP 配置正确。
- 验证 Elasticsearch URL 是否可从您的机器访问。
- 检查您的身份验证凭据（API 密钥或用户名/密码）是否具有必要的权限。
- 如果使用带有自定义 CA 的 SSL/TLS，请验证证书路径是否正确且文件可读。
- 查看终端输出以获取错误消息。
使用教程
使用依赖
- Elasticsearch 实例。
- Elasticsearch 身份验证凭据（API 密钥或用户名/密码）。
- MCP 客户端（例如 Claude Desktop）。
安装教程
- 配置 MCP 客户端
- 打开您的 MCP 客户端。
- 转到 设置 > 开发者 > MCP 服务器。
- 点击
编辑配置并添加一个新的 MCP 服务器，配置如下：
json
{
"mcpServers": {
"elasticsearch-mcp-server": {
"command": "npx",
"args": [
"-y",
"@elastic/mcp-server-elasticsearch"
],
"env": {
"ES_URL": "your-elasticsearch-url",
"ES_API_KEY": "your-api-key"
}
}
}
}
- 开始对话
- 在 MCP 客户端中打开一个新对话。
- MCP 服务器应自动连接。
- 您现在可以询问有关 Elasticsearch 数据的问题。
调试方式
ES_URL=your-elasticsearch-url ES_API_KEY=your-api-key npm run inspector
这将启动 MCP 检查器，允许您调试和分析请求。您应该看到：
Starting MCP inspector...
Proxy server listening on port 3000
🔍 MCP Inspector is up and running at http://localhost:5173 🚀