Cr7258 Elasticsearch MCP Server

🚀 Elasticsearch MCP サーバー

Elasticsearch とのインタラクションを実現するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは一連のツールを通じて、ドキュメントの検索、インデックスの分析、クラスターの管理機能を提供します。

https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c94-b0ff2ea7ff15

🚀 クイックスタート

この Elasticsearch MCP サーバーを使用するには、まず Elasticsearch クラスターを起動し、Claude Desktop を設定する必要があります。以下に手順を説明します。

✨ 主な機能

インデックス操作

• list_indices：Elasticsearch クラスター内のすべてのインデックスを一覧表示します。
• get_mapping：特定のインデックスのマッピング設定を取得します。
• get_settings：特定のインデックスの設定を取得します。

ドキュメント操作

• search_documents：Elasticsearch クエリ DSL を使用してインデックス内のドキュメントを検索します。

クラスター操作

• get_cluster_health：クラスターの健康状態を取得します。
• get_cluster_stats：クラスターの統計情報を取得します。

📦 インストール

Elasticsearch クラスターの起動

Docker Compose を使用して Elasticsearch クラスターを起動します。

docker-compose up -d

これにより、3 ノードの Elasticsearch クラスターと Kibana が起動します。デフォルトの Elasticsearch ユーザー名は elastic、パスワードは test123 です。 Kibana には https://localhost:5601 からアクセスできます。

💻 使用例

基本的な使用法

Claude Desktop を使用して Elasticsearch クラスターとやり取りするには、以下の手順を実行します。

1. Claude Desktop の設定ファイル claude_desktop_config.json に以下の設定を追加します。

{
  "mcpServers": {
    "elasticsearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/elasticsearch_mcp_server/src",
        "run",
        "server.py"
      ],
      "env": {
        "ELASTIC_HOST": "<your_elastic_url>",
        "ELASTIC_USERNAME": "<your_elastic_username>",
        "ELASTIC_PASSWORD": "<your_elastic_password>>"
      }
    }
  }
}

• macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows の場合：%APPDATA%/Claude/claude_desktop_config.json%

2. Claude Desktop を再起動して新しい MCP サーバーを読み込みます。

これで、Claude を通じて自然言語コマンドで Elasticsearch クラスターとやり取りできます。例えば：

• "クラスター内のすべてのインデックスを一覧表示"
• "ボブは何歳ですか？"
• "クラスターの健康状態を表示"