mcp-server-opensearch: An OpenSearch MCP Server

mcp-server-opensearch：OpenSearch MCP サーバー

Model Context Protocol (MCP) は、LLM アプリケーションと外部データソースやツールをシームレスに統合できるオープンプロトコルです。AI 搭載の IDE の構築、チャットインターフェースの強化、カスタム AI ワークフローの作成など、MCP は LLM を必要なコンテキストに接続するための標準化された方法を提供します。

このリポジトリは、分散型検索・分析エンジンである OpenSearch 向けに MCP サーバーを作成する方法の一例です。

建設中

現在の課題 - OpenSearch の非同期クライアントをインストールできない

Open Search 非同期クライアントのドキュメント

pip install opensearch-py[async]
zsh: no matches found: opensearch-py[async]

概要

OpenSearch エンジンでメモリを保存および取得するための、基本的な Model Context Protocol サーバーです。 OpenSearch データベース上にセマンティックメモリレイヤーを構築します。

コンポーネント

ツール

1. search-openSearch
   • OpenSearch データベースにメモリを保存します
   • 入力：
     • 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 run demo.py:main

テスト - ローカルの Open Search クライアント

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

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

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"
    ]
  }, "Demo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "opensearch-py",
        "fastmcp",
        "run",
        "/Users/ibrooks/Documents/GitHub/mcp-server-opensearch/src/mcp-server-opensearch/demo.py"
      ]
    }
}

または FastMCP UI を使用して、サーバーを Claude にインストールします

uv run fastmcp install demo.py

環境変数

サーバーの設定は、環境変数を使用して行うこともできます。

• OPENSEARCH_HOST：OpenSearch サーバーの URL。例：http://localhost
• OPENSEARCH_HOSTPORT：OpenSearch サーバーのホストのポート 9200
• INDEX_NAME：使用するインデックスの名前