Elasticsearch MCP 服务器

概述

一个模型上下文协议 (MCP) 服务器的实现，提供 Elasticsearch 交互。 该服务器支持通过一组工具搜索文档、分析索引和管理集群。

https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c94-b0ff2ea7ff15

功能

索引操作

• list_indices: 列出 Elasticsearch 集群中的所有索引。
• get_mapping: 检索特定索引的映射配置。
• get_settings: 获取特定索引的设置配置。

文档操作

• search_documents: 使用 Elasticsearch Query DSL 在索引中搜索文档。

集群操作

• get_cluster_health: 获取集群的健康状态。
• get_cluster_stats: 获取有关集群的统计信息。

启动 Elasticsearch 集群

使用 Docker Compose 启动 Elasticsearch 集群：

docker-compose up -d

这将启动一个包含 3 个节点的 Elasticsearch 集群和 Kibana。 默认 Elasticsearch 用户名 elastic，密码 test123。

您可以从 https://localhost:5601 访问 Kibana。

与 Claude Desktop 一起使用

1. 将以下配置添加到 Claude Desktop 的配置文件 claude_desktop_config.json：

{
  "mcpServers": {
    "elasticsearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/elasticsearch_mcp_server/src",
        "run",
        "server.py"
      ],
      "env": {
        "ELASTIC_HOST": "<your_elastic_url>",
        "ELASTIC_USERNAME": "<your_elastic_username>",
        "ELASTIC_PASSWORD": "<your_elastic_password>>"
      }
    }
  }
}

• 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

3. 重新启动 Claude Desktop 以加载新的 MCP 服务器。

现在，您可以使用自然语言命令通过 Claude 与您的 Elasticsearch 集群进行交互，例如：

• "列出集群中的所有索引"
• "学生 Bob 多大了？"
• "显示集群健康状态"