Elasticsearch MCP Server

🚀 Elasticsearch

Elasticsearchクラスターに対してモデルコンテキストプロトコル（MCP）サーバーを提供します。LLMがインデックスを管理し、クエリを実行できるようにします。

⚠️ 重要な注意事項

この実装は主に、PostgreSQL MCPサーバーからのサンプルをClaudeに入力することで行われまし。

✨ 主な機能

ツール

• 検索

  • 対象のインデックスに対して検索クエリを実行します。
  • 入力:
    • index（文字列）：対象のインデックス名
    • query（オブジェクト）：ElasticsearchクエリDSL
  • 検索結果を返します。

• インデックスの作成

  • 新しいElasticsearchインデックスを作成します。
  • 入力:
    • index（文字列）：インデックス名
    • mappings（オブジェクト、オプション）：インデックスマッピング設定
    • settings（オブジェクト、オプション）：インデックス設定

• インデックスの一覧表示

  • 利用可能なすべてのインデックスを一覧表示します。
  • 入力不要
  • インデックス情報の配列を返します。

• ドキュメントのインデックス化

  • 指定されたインデックスにドキュメントをインデックス化します。
  • 入力:
    • index（文字列）：対象のインデックス名
    • id（文字列、オプション）：ドキュメントID
    • document（オブジェクト）：ドキュメント内容
  • インデックス操作の結果を返します。

リソース

サーバーは各インデックスに対してマッピング情報を提供します。

• インデックスマッピング (elasticsearch://<ホスト>/<インデックス>/schema)
  • JSON形式のマッピング情報
  • フィールド名、型、および設定
  • メタデータから自動的に検出されます。

💻 使用例

基本的な使用法

Claude Desktopを使用するには、以下の内容をclaude_desktop_config.jsonファイルのmcpServersセクションに追加します。

{
  "mcpServers": {
    "elasticsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-elasticsearch",
        "http://localhost:9200"
      ]
    }
  }
}

高度な使用法

Dockerを使用してElasticsearchを実行するには、次のコマンドを実行します。

docker run -d --name elasticsearch -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" -e "xpack.security.enabled=false" docker.elastic.co/elasticsearch/elasticsearch:8.11.3

URLをあなたのElasticsearchエンドポイントに置き換えてください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。自由に使用、変更、および配布することができます。詳細についてはLICENSEファイルを参照してください。