Elasticsearch MCP サーバー

英語|中国語

任意の MCP クライアント (Claude Desktop、Cursor など) から Elasticsearch クラスターに直接接続するための MCP サーバー。

このサーバーは、モデルコンテキストプロトコルを使用してエージェントをElasticsearchデータに接続します。これにより、自然言語による会話を通じてElasticsearchインデックスと対話できるようになります。

デモ

Related MCP server: Elasticsearch MCP Server

機能の概要

利用可能な機能

クラスター管理

• elasticsearch_health : Elasticsearch クラスターのヘルスステータスを取得します。オプションでインデックスレベルの詳細も取得します。

インデックス操作

• list_indices : 利用可能な Elasticsearch インデックスを一覧表示します。正規表現をサポートします。

• create_index : オプションの設定とマッピングを使用して Elasticsearch インデックスを作成する

• reindex : オプションのクエリとスクリプトを使用して、ソースインデックスからターゲットインデックスにデータを再インデックスします。

マッピング管理

• get_mappings : 特定のElasticsearchインデックスのフィールドマッピングを取得する

• create_mapping : Elasticsearch インデックスのマッピング構造を作成または更新する

検索とデータ操作

• search : 提供されたクエリDSLを使用してElasticsearch検索を実行する

• bulk : Elasticsearch インデックスにデータを一括保存する

テンプレート管理

• create_index_template : インデックステンプレートを作成または更新する

• get_index_template : インデックステンプレートに関する情報を取得する

• delete_index_template : インデックステンプレートを削除する

仕組み

1. MCP クライアントはリクエストを分析し、必要な Elasticsearch 操作を決定します。

2. MCP サーバーはこれらの操作 (インデックスの一覧表示、マッピングの取得、検索の実行) を実行します。

3. MCP クライアントは結果を処理し、ユーザーフレンドリーな形式で表示します。

はじめる

前提条件

• Elasticsearchインスタンス

• Elasticsearch 認証資格情報 (API キーまたはユーザー名/パスワード)

• MCP クライアント (例: Claude Desktop、Cursor)

インストールとセットアップ

公開されたNPMパッケージの使用

1. MCPクライアントの設定

   • MCPクライアントを開きます。MCPクライアントのリストを確認し、ここでClaude Desktopを設定します。

   • 設定 > 開発者 > MCP サーバーに移動します

   • Edit Configをクリックし、次の設定で新しい MCP サーバーを追加します。

   { "mcpServers": { "elasticsearch-mcp": { "command": "npx", "args": [ "-y", "@awesome-ai/elasticsearch-mcp" ], "env": { "ES_HOST": "your-elasticsearch-host", "ES_API_KEY": "your-api-key" } } } }

2. 会話を始める

   • MCP クライアントで新しい会話を開きます。

   • MCP サーバーは自動的に接続されるはずです。

   • Elasticsearch データについて質問できるようになりました。

設定オプション

Elasticsearch MCP サーバーは、Elasticsearch に接続するための構成オプションをサポートしています。

地域開発

1. 正しいNode.jsバージョンを使用する

   nvm use

2. 依存関係をインストールする

   npm install

3. プロジェクトを構築する

   npm run build

4. Claudeデスクトップアプリでローカルに実行

   • Claudeデスクトップアプリを開く

   • 設定 > 開発者 > MCP サーバーに移動します

   • Edit Configをクリックし、次の設定で新しいMCPサーバーを追加します: GXP5

5. カーソルエディタでローカルに実行

   • カーソルエディタを開く

   • カーソル設定 > MCPへ移動します。

   • Add new global MCP Serverをクリックし、次の構成で新しいMCPサーバーを追加します: GXP6

6. MCP Inspectorによるデバッグ

   ES_HOST=your-elasticsearch-url ES_API_KEY=your-api-key npm run inspector

   MCP Inspectorが起動し、リクエストのデバッグと分析が可能になります。以下の画面が表示されます。

   Starting MCP inspector... ⚙️ Proxy server listening on port 6277 🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀

クエリの例

クラスター管理

• 「Elasticsearch クラスターのヘルスステータスはどうですか?」

• 「クラスター内にアクティブノードはいくつありますか？」

インデックス操作

• 「Elasticsearch クラスターにはどのようなインデックスがありますか?」

• 「3 つのシャードと 1 つのレプリカを持つ「users」という新しいインデックスを作成します。」

• 「'old_index' から 'new_index' にデータを再インデックスします。」

マッピング管理

• 「「製品」インデックスのフィールド マッピングを表示します。」

• 「「製品」インデックスに「タグ」というキーワード タイプのフィールドを追加します。」

検索とデータ操作

• 「先月の 500 ドルを超えるすべての注文を検索します。」

• 「5 つ星のレビューを最も多く獲得した製品はどれですか?」

• 「これらの顧客レコードを「顧客」インデックスに一括インポートします。」

テンプレート管理

• 「パターン 'logs-*' のログのインデックス テンプレートを作成します。」

• 「すべてのインデックス テンプレートを表示します。」

• 「'outdated_template' インデックス テンプレートを削除します。」

問題が発生した場合は、お気軽に GitHub リポジトリで問題を報告してください。