OpenSearch MCP Server

OpenSearch MCP サーバー

elasticsearch-mcp-server に着想を得た、OpenSearch 連携用の MCP（Model Context Protocol）サーバーです。

特長

• インデックス管理ツール：
  • OpenSearch クラスター内のすべてのインデックスを一覧表示
  • インデックスのマッピングを取得
  • インデックスの設定を取得
• クラスター管理ツール：
  • クラスターのヘルスステータスを取得
  • クラスターの統計情報を取得
• ドキュメントツール：
  • ドキュメントを検索

インストール

# Clone the repository
git clone https://github.com/your-username/opensearch-mcp-server.git
cd opensearch-mcp-server

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install the package
pip install uv
uv pip install -e .

設定

ルートディレクトリに次の変数を記述した .env ファイルを作成します。

OPENSEARCH_HOST=https://localhost:9200
OPENSEARCH_USERNAME=xxxx
OPENSEARCH_PASSWORD=xxxx

OpenSearch の設定に合わせて値を調整してください。

Cursor での使用方法

MCP サーバーを実行する：

uv run opensearch-mcp-server --port=<port>

Cursor と連携する

{
  "mcpServers": {
    "opensearch": {
      "url": "http://<host>:<port>>/sse"
    }
  }
}

Claude Desktop APP での使用方法

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
          "--directory",
          "/absolute/path/to/opensearch-mcp-server",
          "run",
          "opensearch-mcp-server"
      ]
    }
  }
}

開発

# Install dependencies
uv pip install -e .

# Run tests
uv run pytest -vv -s test_opensearch.py

ライセンス

MIT