OpenSearch MCP Server

OpenSearch MCP Server

概要

このリポジトリはelastic-mcp-serverをフォークし、opensearch-mcp-server MCP サーバーに変換したものです。OpenSearch とのやり取りを可能にする Model Context Protocol（MCP）サーバー実装です。このサーバーは、一連のツールを通じて、ドキュメントの検索、インデックスの分析、クラスターの管理を可能にします。

OpenSearch とのやり取りを可能にする Model Context Protocol（MCP）サーバー実装です。このサーバーは、一連のツールを通じて、ドキュメントの検索、インデックスの分析、クラスターの管理を可能にします。

機能

インデックス操作

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

ドキュメント操作

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

クラスター操作

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

Opensearch クラスターの起動

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

docker-compose up -d

これにより、3 ノードの Opensearch クラスターと Kibana が起動します。Opensearch のデフォルトのユーザー名は opensearch、パスワードは test123 です。

http://localhost:5601 から Kibana にアクセスできます。

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",
        "DASHBOARDS_HOST": "https://localhost:5601"
      }
    }
  }
}

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

Claude Desktop を再起動して、新しい MCP サーバーを読み込みます。

これで、次のような自然言語のコマンドを使って、Claude を通じて Opensearch クラスターを操作できます。

• 「クラスター内のすべてのインデックスを一覧表示して」
• 「学生の Bob の年齢はいくつですか？」
• 「クラスターのヘルスステータスを表示して」

ライセンス

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