Elasticsearch 7.x MCP サーバー

鍛冶屋のバッジ

Elasticsearch 7.x 用の MCP サーバー。Elasticsearch 7.x バージョンとの互換性を提供します。

特徴

Elasticsearch 7.x と対話するための MCP プロトコルインターフェースを提供します
基本的な Elasticsearch 操作 (ping、情報など) をサポートします
集計クエリ、ハイライト、並べ替え、その他の高度な機能を含む完全な検索機能をサポートします。
あらゆるMCPクライアントからElasticsearchの機能に簡単にアクセスできます

Related MCP server: Elasticsearch 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の使用

.envファイルを作成し、 ELASTIC_PASSWORDを設定します。

ELASTIC_PASSWORD=your_secure_password

サービスを開始します。

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"] })