Opensearch MCP Server

🚀 OpenSearch MCP サーバー

このコードライブラリは、[elastic - mcp - server](https://github.com/cr7258/elasticsearch - mcp - server) を分岐させ、[opensearch - mcp - server](https://github.com/seohyunjun/opensearch - mcp - server) へと変換したもので、OpenSearch とのインタラクションを実現しています。これは、モデルコンテキストプロトコル (MCP) サーバーの実装であり、OpenSearch とのやり取りを提供します。このサーバーは、一連のツールを通じて、ユーザーがドキュメントの検索、インデックスの分析、クラスターの管理を行うことができます。

🚀 クイックスタート

このコードライブラリは OpenSearch とのインタラクションを実現する MCP サーバーです。以下の手順でサーバーを起動し、使用することができます。

✨ 主な機能

インデックス操作

• list_indices：OpenSearch クラスター内のすべてのインデックスをリスト表示します。
• get_mapping：特定のインデックスのマッピング設定を取得します。
• get_settings：特定のインデックスの設定を取得します。

ドキュメント操作

• search_documents：OpenSearch クエリ DSL を使用して、インデックス内のドキュメントを検索します。

クラスター操作

• get_cluster_health：クラスターのヘルス状態を取得します。
• get_cluster_stats：クラスターの統計情報を取得します。

📦 インストール

OpenSearch クラスターの起動

Docker Compose を使用して OpenSearch クラスターを起動します。

docker-compose up -d

これにより、3 つのノードを含む OpenSearch クラスターと Kibana が起動します。デフォルトの OpenSearch ユーザー名は opensearch、パスワードは test123 です。 Kibana には http://localhost:5601 からアクセスできます。

💻 使用例

Claude Desktop の使用

ローカル開発での uv の使用

uv を使用するには、コードライブラリをローカルにクローンし、ソースコードのパスを指定する必要があります。以下の設定を Claude Desktop の設定ファイル claude_desktop_config.json に追加します。 path/to/src/opensearch_mcp_server を、クローンしたリポジトリの実際のパスに置き換えてください。

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/opensearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "opensearch",
        "OPENSEARCH_PASSWORD": "test123"
      }
    }
  }
}

• macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows の場合：%APPDATA%/Claude/claude_desktop_config.json%

Claude Desktop を再起動して、新しい MCP サーバーを読み込みます。 これで、自然言語コマンドを使用して OpenSearch クラスターとやり取りできます。例えば：

• "クラスター内のすべてのインデックスをリスト表示"
• "ボブは何歳ですか？"
• "クラスターのヘルス状態を表示"

📄 ライセンス

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