Opensearch MCP Server

🚀 OpenSearch MCP 服務器

本項目代碼庫是 elastic-mcp-server 的分支，將其轉換為 opensearch-mcp-server，實現了與 OpenSearch 的交互。它是一個模型上下文協議 (MCP) 服務器的實現，藉助一系列工具，用戶可實現文檔搜索、索引分析以及集群管理等操作。

🚀 快速開始

啟動 OpenSearch 集群

使用 Docker Compose 啟動 OpenSearch 集群：

docker-compose up -d

這將啟動一個包含三個節點的 OpenSearch 集群和 Kibana。默認 OpenSearch 用戶名 opensearch，密碼 test123。你可以通過 http://localhost:5601 訪問 Kibana。

使用 Claude Desktop

使用 uv 進行本地開發

使用 uv 需要將代碼庫克隆到本地，並指定源代碼路徑。將以下配置添加到 Claude Desktop 的配置文件 claude_desktop_config.json 中。將 path/to/src/opensearch_mcp_server 替換為你克隆倉庫的實際路徑。

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/opensearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "opensearch",
        "OPENSEARCH_PASSWORD": "test123"
      }
    }
  }
}

• 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

重新啟動 Claude Desktop 以加載新的 MCP 服務器。現在你可以通過自然語言命令與 OpenSearch 集群交互，例如：

• "列出集群中的所有索引"
• "鮑勃有多大年紀了？"
• "顯示集群健康狀態"

✨ 主要特性

索引操作

• list_indices：列出 OpenSearch 集群中的所有索引。
• get_mapping：獲取特定索引的映射配置。
• get_settings：獲取特定索引的設置配置。

文檔操作

• search_documents：使用 OpenSearch 查詢 DSL 在索引中搜索文檔。

集群操作

• get_cluster_health：獲取集群的健康狀態。
• get_cluster_stats：獲取集群的統計信息。

📄 許可證

該項目在 Apache License Version 2.0 下 licensed - 有關詳細信息，請參閱 LICENSE 文件。