Elasticsearch/OpenSearch MCP 服务器

概述

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

<a href="https://glama.ai/mcp/servers/b3po3delex"><img width="380" height="200" src="https://glama.ai/mcp/servers/b3po3delex/badge" alt="Elasticsearch MCP Server" /></a>

演示

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

功能

索引操作

• list_indices: 列出所有索引。
• get_index: 返回关于一个或多个索引的信息（映射、设置、别名）。
• create_index: 创建一个新索引。
• delete_index: 删除一个索引。

文档操作

• search_documents: 搜索文档。
• index_document: 在索引中创建或更新文档。
• get_document: 通过 ID 获取文档。
• delete_document: 通过 ID 删除文档。
• delete_by_query: 删除与提供的查询匹配的文档。

集群操作

• get_cluster_health: 返回关于集群健康状况的基本信息。
• get_cluster_stats: 返回集群统计数据的高级概述。

别名操作

• list_aliases: 列出所有别名。
• get_alias: 获取特定索引的别名信息。
• put_alias: 为特定索引创建或更新别名。
• delete_alias: 删除特定索引的别名。

配置环境变量

将 .env.example 文件复制到 .env 并相应地更新值。

启动 Elasticsearch/OpenSearch 集群

使用 Docker Compose 启动 Elasticsearch/OpenSearch 集群：

# For Elasticsearch
docker-compose -f docker-compose-elasticsearch.yml up -d

# For OpenSearch
docker-compose -f docker-compose-opensearch.yml up -d

默认的 Elasticsearch 用户名是 elastic，密码是 test123。 默认的 OpenSearch 用户名是 admin，密码是 admin。

您可以从 http://localhost:5601 访问 Kibana/OpenSearch Dashboards。

与 Claude Desktop 一起使用

选项 1：通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Elasticsearch Server：

npx -y @smithery/cli install elasticsearch-mcp-server --client claude

选项 2：使用 uvx

使用 uvx 将自动从 PyPI 安装软件包，无需在本地克隆存储库。 将以下配置添加到 Claude Desktop 的配置文件 claude_desktop_config.json。

// For Elasticsearch
{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "uvx",
      "args": [
        "elasticsearch-mcp-server"
      ],
      "env": {
        "ELASTICSEARCH_HOST": "https://localhost:9200",
        "ELASTICSEARCH_USERNAME": "elastic",
        "ELASTICSEARCH_PASSWORD": "test123"
      }
    }
  }
}

// For OpenSearch
{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uvx",
      "args": [
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "admin",
        "OPENSEARCH_PASSWORD": "admin"
      }
    }
  }
}

选项 3：使用 uv 进行本地开发

使用 uv 需要在本地克隆存储库并指定源代码的路径。 将以下配置添加到 Claude Desktop 的配置文件 claude_desktop_config.json。

// For Elasticsearch
{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/elasticsearch_mcp_server",
        "run",
        "elasticsearch-mcp-server"
      ],
      "env": {
        "ELASTICSEARCH_HOST": "https://localhost:9200",
        "ELASTICSEARCH_USERNAME": "elastic",
        "ELASTICSEARCH_PASSWORD": "test123"
      }
    }
  }
}

// For OpenSearch
{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/elasticsearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "admin",
        "OPENSEARCH_PASSWORD": "admin"
      }
    }
  }
}

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

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

现在，您可以使用自然语言命令（例如：

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

通过 Claude 与您的 Elasticsearch/OpenSearch 集群进行交互。

与 Anthropic MCP 客户端一起使用

uv run mcp_client/client.py src/server.py

许可证

该项目基于 Apache License Version 2.0 许可证 - 有关详细信息，请参阅 LICENSE 文件。