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、情報など) をサポートします

  • 集計クエリ、ハイライト、並べ替え、その他の高度な機能を含む完全な検索機能をサポートします。

  • あらゆる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 Server を自動的にインストールするには:

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

これにより、3 ノードの 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.
      -