Elasticsearch 7.x MCP Server

Elasticsearch 7.x MCP サーバー

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

機能

• Elasticsearch 7.x と連携するための MCP プロトコルインターフェースを提供します
• 基本的な Elasticsearch 操作（ping、info など）をサポートします
• 集計クエリ、ハイライト表示、ソートなどの高度な機能を含む、完全な検索機能をサポートします
• 任意の MCP クライアントから Elasticsearch の機能に簡単にアクセスできます

必要条件

• 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

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

docker-compose up -d

これにより、Elasticsearch 7.17.10 の 3 ノードクラスター、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 ファイル内のライセンス]

中文文档