OpenSearch MCP Server

OpenSearch MCP サーバー

Model Context Protocol（MCP）を使用して、Cursor、Cline などの任意の MCP クライアントから自然言語で OpenSearch クラスターを直接操作できます。
このサーバーは、クラスターのヘルスステータスの分析、インデックスへのドキュメントの一括登録、インデックスマッピングの取得、ドキュメントの検索などを行うツールを提供します。

ツール

クラスター

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

ドキュメント

• opensearch_bulk：一括操作で複数のドキュメント操作を書き込みます
• opensearch_get_document：インデックスからドキュメントを取得します

インデックス

• opensearch_list_indices：クラスター内のインデックス一覧を取得します
• opensearch_create_index：指定した設定でインデックスを作成します
• opensearch_delete_index：インデックス名を指定してインデックスを削除します
• opensearch_get_index：インデックスの情報を取得します

検索

• opensearch_search：指定したクエリ DSL を使用してインデックスを検索します

前提条件

この MCP サーバーを使用する前に、次のコンポーネントをインストールする必要があります。

• python 3.10 以上
• uv がインストールされていること

使用方法

以下の設定のいずれかを選択して、MCP 設定ファイルに追加してください。その後、OpenSearch クラスターのホスト（複数の場合はカンマ区切り）、ユーザー名、パスワードを MCP サーバーの設定に指定してください。

リモートリポジトリを使用して実行

{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/loupipalien/opensearch-mcp-server",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "your_opensearch_cluster_hosts",
        "OPENSEARCH_USERNAME": "your_opensearch_cluster_username",
        "OPENSEARCH_PASSWORD": "your_opensearch_cluster_password"
      }
    }
  }
}

ローカルリポジトリを使用して実行

{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/repo/src/opensearch_mcp_server",
        "run",
        "server.py"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "your_opensearch_cluster_hosts",
        "OPENSEARCH_USERNAME": "your_opensearch_cluster_username",
        "OPENSEARCH_PASSWORD": "your_opensearch_cluster_password"
      }
    }
  }
}

OpenSearch クラスターの起動

OpenSearch クラスターがない場合は、ローカルリポジトリのルートディレクトリで次のコマンドを実行して起動できます。詳しくはこちらをご覧ください。
2 ノードクラスターとダッシュボードが作成されます。デフォルトのユーザー名は admin、パスワードは your_opensearch_cluster_password です。クラスターには https://localhost:9200 から、ダッシュボードには http://localhost:5601 からアクセスできます。

export OPENSEARCH_INITIAL_ADMIN_PASSWORD=your_opensearch_cluster_password

docker-compose up -d

クラスターとダッシュボードを停止します

docker-compose down -v

ライセンス

このプロジェクトはApache v2.0 Licenseのもとでライセンスされています。