mcp-server-opensearch: An OpenSearch MCP Server

mcp-server-opensearch：一个 OpenSearch MCP 服务

Model Context Protocol (MCP) 是一种开放协议，可让大模型应用与外部数据源和工具无缝集成。无论你是在构建 AI 驱动的 IDE、增强聊天界面，还是创建自定义 AI 工作流，MCP 都提供了一种标准化方式，让大模型连接到所需的上下文。

此代码库展示了如何为 OpenSearch 创建 MCP 服务。OpenSearch 是一个分布式搜索和分析引擎。

正在施工

当前阻碍 - OpenSearch 的异步客户端无法安装

Open Search Async Client Docs

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

概述

一个基础的模型上下文协议服务，用于在 OpenSearch 引擎中保存和检索记忆。 它作为构建在 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：要使用的索引名称