MCP 服务器

Elasticsearch MCP Server

将 Claude 和其他 MCP 客户端连接到 Elasticsearch 数据，允许用户通过自然语言对话与他们的 Elasticsearch 索引进行交互。

Tools

list_indices

List all available Elasticsearch indices

get_mappings

Get field mappings for a specific Elasticsearch index

Perform an Elasticsearch search with the provided query DSL. Highlights are always enabled.

README

Elasticsearch MCP 服务器

使用模型上下文协议 (MCP) 直接从任何 MCP 客户端（如 Claude Desktop）连接到您的 Elasticsearch 数据。

此服务器使用模型上下文协议将代理连接到您的 Elasticsearch 数据。它允许您通过自然语言对话与您的 Elasticsearch 索引进行交互。

可用工具

list_indices: 列出所有可用的 Elasticsearch 索引
get_mappings: 获取特定 Elasticsearch 索引的字段映射
search: 使用提供的查询 DSL 执行 Elasticsearch 搜索

前提条件

一个 Elasticsearch 实例
Elasticsearch 身份验证凭据（API 密钥或用户名/密码）
MCP 客户端（例如 Claude Desktop）

演示

https://github.com/user-attachments/assets/5dd292e1-a728-4ca7-8f01-1380d1bebe0c

安装与设置

使用已发布的 NPM 包

[!TIP] 使用 Elasticsearch MCP 服务器的最简单方法是通过已发布的 npm 包。

配置 MCP 客户端

打开您的 MCP 客户端。请参阅 MCP 客户端列表，这里我们配置的是 Claude Desktop。
转到 Settings > Developer > MCP Servers
点击 Edit Config 并添加一个新的 MCP 服务器，配置如下：

{
  "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 数据的问题

配置选项

Elasticsearch MCP 服务器支持配置选项以连接到您的 Elasticsearch：

[!NOTE] 您必须提供 API 密钥或用户名和密码才能进行身份验证。

环境变量	描述	是否必需
`ES_URL`	您的 Elasticsearch 实例 URL	是
`ES_API_KEY`	用于身份验证的 Elasticsearch API 密钥	否
`ES_USERNAME`	用于基本身份验证的 Elasticsearch 用户名	否
`ES_PASSWORD`	用于基本身份验证的 Elasticsearch 密码	否
`ES_CA_CERT`	Elasticsearch SSL/TLS 的自定义 CA 证书路径	否

本地开发

[!NOTE] 如果您想修改或扩展 MCP 服务器，请按照以下本地开发步骤操作。

使用正确的 Node.js 版本
```
nvm use
```
安装依赖
```
npm install
```
构建项目
```
npm run build
```

在 Claude Desktop App 中本地运行

打开 Claude Desktop App
转到 Settings > Developer > MCP Servers
点击 Edit Config 并添加一个新的 MCP 服务器，配置如下：

{
  "mcpServers": {
    "elasticsearch-mcp-server-local": {
      "command": "node",
      "args": [
        "/path/to/your/project/dist/index.js"
      ],
      "env": {
        "ES_URL": "your-elasticsearch-url",
        "ES_API_KEY": "your-api-key"
      }
    }
  }
}

使用 MCP Inspector 调试

ES_URL=your-elasticsearch-url ES_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 🚀

示例问题

[!TIP] 以下是一些您可以使用 MCP 客户端尝试的自然语言查询。

"我的 Elasticsearch 集群中有哪些索引？"
"显示 'products' 索引的字段映射。"
"查找上个月超过 500 美元的所有订单。"
"哪些产品收到了最多的 5 星评价？"

工作原理

MCP 客户端分析您的请求并确定需要哪些 Elasticsearch 操作。
MCP 服务器执行这些操作（列出索引、获取映射、执行搜索）。
MCP 客户端处理结果并以用户友好的格式呈现它们。

安全最佳实践

[!WARNING] 避免使用 cluster-admin 权限。创建具有有限范围的专用 API 密钥，并在索引级别应用细粒度的访问控制，以防止未经授权的数据访问。

您可以创建一个具有最小权限的专用 Elasticsearch API 密钥来控制对您的数据的访问：

POST /_security/api_key
{
  "name": "es-mcp-server-access",
  "role_descriptors": {
    "mcp_server_role": {
      "cluster": [
        "monitor"
      ],
      "indices": [
        {
          "names": [
            "index-1",
            "index-2",
            "index-pattern-*"
          ],
          "privileges": [
            "read",
            "view_index_metadata"
          ]
        }
      ]
    }
  }
}