MCP Server Elasticsearch

🚀 Elasticsearch MCP サーバー

MCP クライアント（Claude Desktop など）を通じて、直接 Elasticsearch データに接続できます。

このサーバーは、Model Context Protocol (MCP) を使用して、Elasticsearch データへの代理接続を行います。自然言語対話で Elasticsearch インデックスとやり取りできるようになります。

✨ 主な機能

• list_indices：利用可能なすべての Elasticsearch インデックスをリスト表示します。
• get_mappings：特定の Elasticsearch インデックスのフィールドマッピングを取得します。
• 搜索：提供されたクエリ DSL を使用して Elasticsearch 検索を実行します。
• get_shards：すべてまたは特定のインデックスのシャード情報を取得します。

📦 インストール

必要条件

• Elasticsearch インスタンス
• Elasticsearch 認証資格情報（API キーまたはユーザー名/パスワード）
• MCP クライアント（Claude Desktop など）

インストール手順

ステップ 1：Elasticsearch のインストール

公式ドキュメントに従って Elasticsearch をインストールします。

ステップ 2：Elasticsearch の設定

elasticsearch.yml ファイルを編集し、以下の内容を追加します。

plugins.security.enabled: true
plugins.security.ssl.enabled: true

Elasticsearch サービスを再起動して変更を適用します。

MCP クライアントの接続

MCP クライアント（Claude Desktop など）を使用して Elasticsearch に接続します。

💻 使用例

基本的な使用法

以下は、提供されたツールの使用例です。

インデックスの一覧表示

# `list_indices` を使用してすべてのインデックスをリスト表示

フィールドマッピングの取得

# `get_mappings` を使用して特定のインデックスのフィールドマッピングを取得

検索の実行

# `搜索` を使用してクエリ DSL で検索を実行

シャード情報の取得

# `get_shards` を使用してシャード情報を取得

🔧 技術詳細

セキュリティのベストプラクティス

⚠️ 重要提示

クラスタ管理者権限の使用は避けてください。最小限の権限を持つ専用の API キーを作成し、インデックスレベルで細粒度のアクセス制御を適用して、不正なデータアクセスを防止します。

以下は、制限付きの権限を持つ専用の Elasticsearch API キーを作成する例です。

POST /_security/api_key
{
  "name": "es-mcp-server-access",
  "role_descriptors": {
    "mcp_server_role": {
      "cluster": [
        "monitor"
      ],
      "indices": [
        {
          "names": [
            "index-1",
            "index-2",
            "index-pattern-*"
          ],
          "privileges": [
            "read",
            "view_index_metadata"
          ]
        }
      ]
    }
  }
}

📄 ライセンス

本プロジェクトは、Apache License 2.0 の下でライセンスされています。

トラブルシューティング

• MCP の設定が正しいことを確認してください。
• Elasticsearch URL がマシンからアクセス可能であることを検証してください。
• 認証資格情報（API キーまたはユーザー名/パスワード）に必要な権限があることを確認してください。
• SSL/TLS とカスタム CA を使用する場合は、証明書のパスが正しく、ファイルが読み取り可能であることを検証してください。
• ターミナル出力のエラーメッセージを確認してください。

問題が発生した場合は、GitHub リポジトリで issue を開いてください。

サンプルデモ

https://github.com/user-attachments/assets/5dd292e1-a37b-4f1a-b8d5-765f14dfe0c0