小贴士:按下Ctrl+D 或 ⌘+D,一键收藏本站,方便下次快速访问!
Apache License 2.0
2
最近更新:2个月前

与OpenSearch集成,为需要高级搜索和日志分析的应用程序提供强大的全文检索、数据聚合和实时分析功能。

mcp-server-opensearch: OpenSearch MCP 服务器

smithery 徽章

模型上下文协议 (MCP) 是一个开放协议,可实现 LLM 应用与外部数据源和工具的无缝集成。无论您是在构建 AI 驱动的 IDE、增强聊天界面,还是创建自定义 AI 工作流,MCP 都提供了连接 LLM 与其所需上下文的标准方法。

本仓库展示了如何为 OpenSearch(一个分布式搜索和分析引擎)创建 MCP 服务器。

正在建设中

image1
image2

当前阻碍 - OpenSearch 异步客户端安装失败

OpenSearch 异步客户端文档

shell 复制代码
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:

bash 复制代码
npx -y @smithery/cli install @ibrooksSDX/mcp-server-opensearch --client claude

使用 uv (推荐)

使用 uv 时,无需特定安装即可直接运行 mcp-server-opensearch

shell 复制代码
uv run mcp-server-opensearch \
  --opensearch-url "http://localhost:9200" \
  --index-name "my_index" \

shell 复制代码
uv run fastmcp run demo.py:main

测试 - 本地 OpenSearch 客户端

image4
shell 复制代码
uv run python src/mcp-server-opensearch/test_opensearch.py

测试 - MCP 服务器连接到 OpenSearch 客户端

image1
image2

shell 复制代码
cd src/mcp-server-opensearch
uv run fastmcp dev demo.py

与 Claude Desktop 配合使用

要在 Claude Desktop 应用中使用此服务器,请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分:

json 复制代码
{
  "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

shell 复制代码
uv run fastmcp install demo.py

环境变量

服务器配置也可以通过环境变量完成:

  • OPENSEARCH_HOST: OpenSearch 服务器 URL,例如 http://localhost
  • OPENSEARCH_HOSTPORT: OpenSearch 服务器主机端口 9200
  • INDEX_NAME: 要使用的索引名称