Es MCP Server

🚀 Elasticsearch MCP サーバー

このプロジェクトは、Elasticsearch用のMCP（モデルコンテキストプロトコル）サーバーを実装し、Elasticsearchクラスタとのインタラクションに必要なツールとリソースを提供します。

✨ 主な機能

ツール

• list_indices：Elasticsearchクラスタ内のすべてのインデックスをリスト表示します。
• get_mappings：特定のインデックスのマッピング情報を取得します。
• search：提供されたクエリDSLを使用してElasticsearch検索を実行します。
• search_with_query_string：簡単なクエリ文字列で検索を実行します。
• get_index_stats：特定のインデックスの統計情報を取得します。

リソース

• elasticsearch://indices：すべてのElasticsearchインデックスをリスト表示します。
• elasticsearch://index/{index_name}：特定のインデックスの詳細情報を取得します。
• elasticsearch://mapping/{index_name}：特定のインデックスのマッピング情報を取得します。

📦 インストール

前提条件

• Python 3.7+
• Elasticsearch Python クライアント
• MCP SDK
• Elasticsearch クラスタの認証情報（Cloud ID と API Key）

セットアップ手順

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/elasticsearch-mcp-server.git
   cd elasticsearch-mcp-server
   

2. 必要な依存関係をインストールします：

   pip install -r requirements.txt
   

3. 環境変数を設定します：

   • サンプル環境ファイルをコピーします：cp .env.example .env
   • .envファイルを編集し、Elasticsearchの認証情報を追加します。 または、シェルで直接設定することもできます：

   export ES_CLOUD_ID=your_elasticsearch_cloud_id
   export ES_API_KEY=your_elasticsearch_api_key
   

💻 使用例

ClaudeでのMCPサーバーの設定

configure_mcp_server.pyスクリプトを使用すると、ClaudeのMCP設定ファイルにElasticsearch MCPサーバーを設定できます。これにより、ClaudeはMCPサーバーを介してElasticsearchクラスタに接続できます。

python configure_mcp_server.py your_cloud_id your_api_key

このスクリプトは以下のことを行います：

1. コマンドライン引数からElasticsearchのCloud IDとAPI Keyを取得します。
2. ClaudeのMCP設定ファイルを検索または作成します。
3. Elasticsearch MCPサーバーの設定を追加または更新します。
4. サーバーがElasticsearchクラスタに接続するために必要な環境変数を設定します。

このスクリプトを実行した後、VS Codeを再起動して変更を適用します。ClaudeはMCPサーバーを介してElasticsearchクラスタとインタラクションできるようになります。

テストリソース

すべてのリソースには適切なエラー処理と検証が含まれています：

• インデックスが存在しない場合、リソースは適切なエラーメッセージを返します。
• Elasticsearchへの接続に問題がある場合、リソースはエラーメッセージを返します。
• すべての例外はキャプチャされ、読みやすいエラーメッセージとして返されます。

🤝 コントリビューション

コントリビューションを歓迎します！以下はコントリビュートする方法です：

1. リポジトリをフォークします。
2. 機能ブランチを作成します：git checkout -b feature/your-feature-name
3. 変更をコミットします：git commit -am 'Add some feature'
4. ブランチにプッシュします：git push origin feature/your-feature-name
5. プルリクエストを提出します。

📂 GitHubリポジトリ

このプロジェクトはGitHubにアップロードできる状態です。リポジトリには以下が含まれています：

• 機密情報やログを除外する.gitignoreファイル
• ユーザーが環境変数を設定するのをガイドする.env.exampleファイル
• 依存関係をリストするrequirements.txtファイル
• MITライセンスを含むLICENSEファイル
• 完全なドキュメントが記載されたREADME.md

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細についてはLICENSEファイルを参照してください。