Elasticsearch MCP Server

🚀 Elasticsearch/OpenSearch MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装し、ElasticsearchとOpenSearchとの相互作用を可能にします。一連のツールを通じて、ドキュメントの検索、インデックスの分析、クラスターの管理などの機能を提供します。

🚀 クイックスタート

デモ

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

✨ 主な機能

インデックス操作

• list_indices：クラスター内のすべてのインデックスをリストします。
• create_index：新しいインデックスを作成します。
• delete_index：指定されたインデックスを削除します。
• update_mapping：インデックスのマッピングを更新します。

ドキュメント操作

• search_docs：指定されたインデックス内のドキュメントを検索します。
• get_doc：指定されたインデックスとIDのドキュメントを取得します。
• index_doc：指定されたインデックスにドキュメントを追加または更新します。
• delete_doc：指定されたインデックスとIDのドキュメントを削除します。

クラスター操作

• cluster_health：クラスターのヘルスステータスを確認します。
• cluster_stats：クラスターの統計情報を取得します。
• nodes_info：クラスター内のすべてのノードとその情報をリストします。
• nodes_stats：各ノードの詳細な統計情報を取得します。

エイリアス操作

• list_aliases：指定されたインデックスのすべてのエイリアスをリストします。
• create_alias：新しいエイリアスを作成します。
• delete_alias：指定されたエイリアスを削除します。
• update_alias：既存のエイリアスの設定を更新します。

📦 インストール

環境変数の設定

# Elasticsearch 設定
ELASTICSEARCH_HOSTS=http://localhost:9200
ELASTICSEARCH_USERNAME=
ELASTICSEARCH_PASSWORD=

# OpenSearch 設定（必要な場合）
OPENSEARCH_HOSTS=http://localhost:9200
OPENSEARCH_USERNAME=
OPENSEARCH_PASSWORD=

Docker を使用した Elasticsearch/OpenSearch クラスターの起動

# Elasticsearch の起動
docker run -d --name elasticsearch -p 9200:9200 -p 9300:9300 docker.elastic.co/elasticsearch/elasticsearch:7.17.2

# OpenSearch の起動
docker run -d --name opensearch -p 9200:9200 -p 9300:9300 amazon/opensearch:1.5.0

Claude Desktop での使用方法

方法一：uv コマンドを使用したインストール

# Elasticsearch バージョン
uv run mcp_client/client.py src/server.py --elasticsearch

# OpenSearch バージョン
uv run mcp_client/client.py src/server.py --opensearch

📄 ライセンス

このプロジェクトは、Apache License Version 2.0 の下でオープンソースとして公開されています。詳細については、LICENSE ファイルを参照してください。