mcp-server-opensearch: An OpenSearch MCP Server
2025.02.19
2
Python语义记忆层OpenSearch 集成数据库
mcp-server-opensearch 是一个基于 OpenSearch 的 MCP（Model Context Protocol）服务器，旨在为大型语言模型（LLM）应用提供语义记忆层。它通过标准化的 MCP 协议，将 LLM 应用与 OpenSearch 数据库无缝集成，实现记忆的存储和检索。
View on GitHub
Overview
基本能力
产品定位
mcp-server-opensearch 是一个语义记忆层服务，基于 OpenSearch 数据库，为 LLM 应用提供记忆存储和检索功能。
核心功能
- 语义记忆存储与检索：通过 OpenSearch 实现记忆的存储和语义搜索。
- MCP 协议兼容：支持 Model Context Protocol，便于与 LLM 应用集成。
- 工具支持：提供
search-openSearch工具，用于存储记忆到 OpenSearch 数据库。
适用场景
- AI 增强的 IDE：为开发工具提供上下文记忆功能。
- 聊天界面增强：存储和检索聊天历史或上下文信息。
- 自定义 AI 工作流：在复杂工作流中管理记忆和上下文。
工具列表
search-openSearch：- 功能：将记忆存储到 OpenSearch 数据库。
- 输入：
query（JSON 格式的查询消息）。 - 输出：确认消息。
常见问题解答
- 异步客户端安装问题：
- 问题：
pip install opensearch-py[async]安装失败。 - 解决方案：参考 OpenSearch Async Client Docs。
使用教程
使用依赖
- 确保已安装 Python 和 pip。
- 安装 OpenSearch 异步客户端（如遇到问题，参考常见问题解答）。
安装教程
- 通过 Smithery 安装：
bash npx -y @smithery/cli install @ibrooksSDX/mcp-server-opensearch --client claude - 使用 uv 运行：
shell uv run mcp-server-opensearch \ --opensearch-url "http://localhost:9200" \ --index-name "my_index"或shell uv run fastmcp run demo.py:main
调试方式
- 测试本地 OpenSearch 客户端：
shell uv run python src/mcp-server-opensearch/test_opensearch.py - 测试 MCP 服务器连接：
shell cd src/mcp-server-opensearch uv run fastmcp dev demo.py
与 Claude Desktop 集成
在 claude_desktop_config.json 中添加以下配置：
{
"opensearch": {
"command": "uvx",
"args": [
"mcp-server-opensearch",
"--opensearch-url",
"http://localhost:9200",
"--opensearch-api-key",
"your_api_key",
"--index-name",
"your_index_name"
]
}
}
或使用 FastMCP UI 安装：
uv run fastmcp install demo.py
环境变量配置
OPENSEARCH_HOST: OpenSearch 服务器 URL（如http://localhost）。OPENSEARCH_HOSTPORT: OpenSearch 服务器端口（如9200）。INDEX_NAME: 使用的索引名称。