🚀 Elasticsearch MCP 服务器

Elasticsearch MCP 服务器可让您通过 MCP 客户端（如 Claude Desktop）直接连接到 Elasticsearch 数据。它借助 Model Context Protocol (MCP) 代理连接到 Elasticsearch 数据，支持您通过自然语言对话与 Elasticsearch 索引进行交互。

🚀 快速开始

本服务器允许您借助 MCP 客户端，以自然语言对话的方式与 Elasticsearch 索引交互。您可以使用提供的工具列出索引、获取映射、执行搜索等操作。

✨ 主要特性

• 自然语言交互：支持通过自然语言对话与 Elasticsearch 索引进行交互。
• 丰富工具集：提供 list_indices、get_mappings、搜索、get_shards 等实用工具。

📦 安装指南

使用 Elasticsearch MCP 服务器连接

步骤 1：安装 Elasticsearch

按照官方文档安装 Elasticsearch。

步骤 2：配置 Elasticsearch

编辑 elasticsearch.yml 文件，添加以下内容：

plugins.security.enabled: true
plugins.security.ssl.enabled: true

重启 Elasticsearch 服务以应用更改。

连接 MCP 客户端

使用 MCP 客户端（如 Claude Desktop）连接到 Elasticsearch。

💻 使用示例

基础用法

以下是使用各工具的示例：

• list_indices：列出所有可用的 Elasticsearch 索引。
• get_mappings：获取特定 Elasticsearch 索引的字段映射。
• 搜索：使用提供的查询 DSL 执行 Elasticsearch 搜索。
• get_shards：获取所有或特定索引的分片信息。

📚 详细文档

可用工具

• list_indices：列出所有可用的 Elasticsearch 索引。
• get_mappings：获取特定 Elasticsearch 索引的字段映射。
• 搜索：使用提供的查询 DSL 执行 Elasticsearch 搜索。
• get_shards：获取所有或特定索引的分片信息。

先决条件

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

示例演示

您可以查看此示例演示：示例演示链接

安全最佳实践

⚠️ 重要提示 避免使用集群管理员权限。创建具有最小权限的专用 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"
          ]
        }
      ]
    }
  }
}

故障排除

• 确保您的 MCP 配置正确。
• 验证您的 Elasticsearch URL 是否可以从您的机器访问。
• 检查您的认证凭据（API 密钥或用户名/密码）是否具有必要的权限。
• 如果使用 SSL/TLS 和自定义 CA，请验证证书路径是否正确且文件可读。
• 查看终端输出中的错误信息。

如果遇到问题，请在 GitHub 仓库中打开一个 issue。

📄 许可证

本项目 licensed under the Apache License 2.0.