Opensearch

🚀 MCP-Server-OpenSearch：OpenSearch MCPサーバー

モデルコンテキストプロトコル（MCP）は、LLMアプリケーションと外部データソースやツールをシームレスに統合するためのオープンプロトコルです。AI駆動のIDEを構築したり、チャットインターフェイスを強化したり、カスタムAIワークフローを作成したりする場合でも、MCPはLLMと必要なコンテキストを接続する標準的な方法を提供します。

このリポジトリは、分散型検索および分析エンジンであるOpenSearch用のMCPサーバーを作成する方法を示しています。

⚠️ 重要提示

Open Search Async Client ドキュメントに記載されている通り、OpenSearchの非同期クライアントをインストールできません。

pip install opensearch-py[async]
zsh: 没有匹配项：opensearch-py[async]

🚀 クイックスタート

このサーバーは、OpenSearchエンジン内でメモリの保存と検索を行う基本的なモデルコンテキストプロトコルサーバーです。OpenSearchデータベース上のセマンティックメモリ層として機能します。

✨ 主な機能

ツール

1. search-openSearch
   • OpenSearchデータベースに1つのメモリを保存します。
   • 入力:
     • query（json）: 準備されたJSONクエリメッセージ
   • 戻り値: 確認メッセージ

📦 インストール

Smitheryを使用したインストール

Smitheryを通じて、Claude Desktopで使用するためのmcp-server-opensearchを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @ibrooksSDX/mcp-server-opensearch --client claude

uvを使用する（推奨）

uvを使用する場合、特定のインストールは必要なく、直接mcp-server-opensearchを実行できます。

uv run mcp-server-opensearch \
  --opensearch-url "http://localhost:9200" \
  --index-name "my_index" \

または

uv run fastmcp 运行 demo.py:main

💻 使用例

ローカルOpenSearchクライアントでのテスト

uv run python src/mcp-server-opensearch/test_opensearch.py

MCPサーバーとOpenSearchクライアントの接続テスト

cd src/mcp-server-opensearch
uv run fastmcp dev demo.py

Claude Desktopとの連携

このサーバーをClaude Desktopアプリケーションと一緒に使用するには、claude_desktop_config.jsonの「mcpServers」セクションに以下の設定を追加します。

{
  "opensearch": {
    "command": "uvx",
    "args": [
      "mcp-server-opensearch",
      "--opensearch-url",
      "http://localhost:9200",
      "--opensearch-api-key",
      "your_api_key",
      "--index-name",
      "your_index_name"
    ]
  }
}

その後、以下のコマンドを実行してインストールします。

uv run fastmcp 安装

🔧 技術詳細

環境変数

以下は使用できる環境変数とその説明です。

サーバーを実行する前に、これらの環境変数を設定することを確認してください。