Opensearch MCP Server Zf2

🚀 OpenSearch MCP サーバー

elasticsearch-mcp-server と共同で開発された、OpenSearch を統合した MCP（モデルコンテキストプロトコル）サーバーです。

✨ 主な機能

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

📦 インストール

# リポジトリをクローン
git clone https://github.com/your-username/opensearch-mcp-server.git
cd opensearch-mcp-server

# 仮想環境を作成してアクティブ化
python -m venv .venv
source .venv/bin/activate  # Windows システムでは：.venv\Scripts\activate

# パッケージをインストール
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=<ポート>

Cursor の接続設定

Cursor で以下のように設定します。

{
  "mcpServers": {
    "opensearch": {
      "url": "http://<ホスト>:<ポート>/sse"
    }
  }
}

Claude Desktop APP との統合

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

開発ガイド

# 依存関係をインストール
uv pip install -e .

# テストを実行
uv run pytest -vv -s test_opensearch.py

📄 ライセンス

MIT