Elasticsearch7 MCP Server

🚀 Elasticsearch 7.x MCP サーバー

Elasticsearch 7.x 用の MCP プロトコルインターフェースを提供するサーバーで、Elasticsearch 7.x バージョンと互換性があります。

🚀 クイックスタート

このサーバーは、Elasticsearch 7.x 用の MCP プロトコルインターフェースを提供し、Elasticsearch 7.x バージョンとの互換性をサポートします。

✨ 主な機能

• Elasticsearch 7.x の MCP プロトコルインターフェースを提供します。
• 基本的な Elasticsearch 操作（ハートビート検出、情報照会など）をサポートします。
• 集約クエリ、ハイライト表示、ソートなどの高度な機能を含む完全な検索機能をサポートします。
• 任意の MCP クライアントから簡単に Elasticsearch の機能にアクセスできます。

📦 インストール

必要条件

インストール方法

Smithery を使用した自動インストール

Smithery を通じて、Claude デスクトップに 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

2. サービスを起動します。

docker-compose up -d

これにより、3 ノードの Elasticsearch 7.17.10 クラスター、Kibana、および MCP サーバーが起動します。

💻 使用例

基本的な使用法

MCP クライアントを使用して MCP サーバーに接続することができます。

from mcp import MCPClient

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

高度な使用法

基本検索

response = client.call("es-search", body={
    "query": {
        "match_all": {}
    }
})
print(response)

フィルター付き検索

response = client.call("es-search", body={
    "query": {
        "term": {
            "field": "value"
        }
    }
}, index="your_index_name")
print(response)

📚 ドキュメント

環境変数の説明

開発ガイド

1. リポジトリをクローンします。

git clone https://github.com/your-repository.git
cd your-repository

2. 依存関係をインストールします。

pip install -r requirements.txt

3. サーバーを起動します。

python server.py

📄 ライセンス

ライセンス情報については、LICENSE ファイルを参照してください。