Imlewc Elasticsearch7 MCP Server

🚀 Elasticsearch 7.x MCP サーバー

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

✨ 主な機能

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

📦 インストール

依存関係

• Python 3.10+
• Elasticsearch 7.x（7.17.x バージョンの使用を推奨）

使用 Smithery 自動インストール

Smithery を通じて、Elasticsearch 7.x MCP Server for Claude Desktop を自動インストールします：

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 クライアントを使用して 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 インデックス内のドキュメントを検索します。

基本的な使用法

# 基本検索
search_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "match": {
            "title": "搜索关键词"
        }
    },
    "size": 10,
    "from": 0
})

高度な使用法

集計クエリ

# 集計クエリ
agg_response = client.call("es-search", {
    "index": "my_index",
    "size": 0,  # 集計結果のみ必要で、ドキュメント内容は不要
    "aggs": {
        "categories": {
            "terms": {
                "field": "category.keyword",
                "size": 10
            }
        },
        "avg_price": {
            "avg": {
                "field": "price"
            }
        }
    }
})

ハイライトとソート付きの高度な検索

# ハイライトとソート付きの高度な検索
search_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "multi_match": {
            "query": "搜索关键词",
            "fields": ["title", "content"]
        }
    },
    "highlight": {
        "pre_tag": "<em>",
        "post_tag": "</em>",
        "fields": {
            "title": {},
            "content": {}
        }
    },
    "sort": [
        {"price": { "order": "asc" }}
    ]
})

開発

プロジェクトのルートディレクトリで以下のコマンドを実行してサーバーを起動します：

python -m elasticsearch_mcp_server

デフォルトでは、サーバーは http://localhost:9999 で起動します。

📄 ライセンス

このプロジェクトは MIT License に基づいてライセンスされています。