Skip to main content
Glama
Elasticsearch 7.x MCP Server

Elasticsearch 7.x MCP Server

by imlewc

Elasticsearch 7.x MCP 服务器

铁匠徽章

Elasticsearch 7.x 的 MCP 服务器,提供与 Elasticsearch 7.x 版本的兼容性。

特征

  • 提供与 Elasticsearch 7.x 交互的 MCP 协议接口

  • 支持基本的 Elasticsearch 操作(ping、info 等)

  • 支持完整的搜索功能,包括聚合查询、突出显示、排序和其他高级功能

  • 通过任何 MCP 客户端轻松访问 Elasticsearch 功能

Related MCP server: Elasticsearch/OpenSearch MCP Server

要求

  • Python 3.10+

  • Elasticsearch 7.x(推荐 7.17.x)

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Elasticsearch 7.x MCP 服务器:

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

手动安装

pip install -e .

环境变量

服务器需要以下环境变量:

  • ELASTIC_HOST :Elasticsearch 主机地址(例如http://localhost:9200 )

  • ELASTIC_USERNAME :Elasticsearch 用户名

  • ELASTIC_PASSWORD :Elasticsearch 密码

  • MCP_PORT :(可选)MCP 服务器监听端口,默认 9999

使用 Docker Compose

  1. 创建一个.env文件并设置ELASTIC_PASSWORD :

ELASTIC_PASSWORD=your_secure_password
  1. 启动服务:

docker-compose up -d

这将启动一个三节点 Elasticsearch 7.17.10 集群、Kibana 和 MCP 服务器。

使用 MCP 客户端

您可以使用任何 MCP 客户端连接到 MCP 服务器:

from mcp import MCPClient

client = MCPClient("localhost:9999")
response = client.call("es-ping")
print(response)  # {"success": true}

API 文档

目前支持的 MCP 方法:

  • es-ping :检查 Elasticsearch 连接

  • es-info :获取 Elasticsearch 集群信息

  • es-search :在 Elasticsearch 索引中搜索文档

搜索 API 示例

基本搜索

# Basic search
search_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "match": {
            "title": "search keywords"
        }
    },
    "size": 10,
    "from": 0
})

聚合查询

# Aggregation query
agg_response = client.call("es-search", {
    "index": "my_index",
    "size": 0,  # Only need aggregation results, no documents
    "aggs": {
        "categories": {
            "terms": {
                "field": "category.keyword",
                "size": 10
            }
        },
        "avg_price": {
            "avg": {
                "field": "price"
            }
        }
    }
})

高级搜索

# Advanced search with highlighting, sorting, and filtering
advanced_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "bool": {
            "must": [
                {"match": {"content": "search term"}}
            ],
            "filter": [
                {"range": {"price": {"gte": 100, "lte": 200}}}
            ]
        }
    },
    "sort": [
        {"date": {"order": "desc"}},
        "_score"
    ],
    "highlight": {
        "fields": {
            "content": {}
        }
    },
    "_source": ["title", "date", "price"]
})

发展

  1. 克隆存储库

  2. 安装开发依赖项

  3. 运行服务器: elasticsearch7-mcp-server

执照

[LICENSE 文件中的许可证]

中文詳細

Available Tools

3 tools
es-infoC

Get Elasticsearch info

Inputs: req (required).

es-pingC

Ping Elasticsearch server

Inputs: req (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: es-info retrieves server information, es-ping checks connectivity, and es-search performs document searches. There is no overlap or ambiguity between these functions, making tool selection straightforward for an agent.

    Naming Consistency5/5

    All tool names follow a consistent 'es-' prefix and underscore-separated verb pattern (es-info, es-ping, es-search). This predictable naming convention enhances readability and usability across the tool set.

    Tool Count2/5

    With only 3 tools, the server feels thin for an Elasticsearch domain, which typically involves operations like indexing, updating, deleting, and aggregating documents. The count is too low to cover the expected scope of a database/search engine server.

    Completeness2/5

    The tool set is severely incomplete for Elasticsearch functionality. It lacks essential CRUD operations (e.g., create, update, delete documents), index management, and query features beyond basic search, which will likely cause agent failures in handling typical database tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      Facilitates interaction with Elasticsearch clusters by allowing users to perform index operations, document searches, and cluster management via a Model Context Protocol server and natural language commands.
      20
      317
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that enables interaction with Elasticsearch and OpenSearch clusters for searching documents and managing indices. It provides tools for cluster health monitoring, index configuration, and general API requests.
      16
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables secure and efficient interaction with Elasticsearch clusters through the Model Context Protocol, providing tools for data management, search, and export.
      3,584 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables read-only interaction with Elasticsearch, supporting listing indices, retrieving mappings, and executing search/aggregation queries via MCP.
      -