OpenSearch MCP 服务器

基于 elasticsearch-mcp-server 携手打造的 OpenSearch 集成 MCP（模型上下文协议）服务器。

功能特性

• 索引管理工具：
  • 列出 OpenSearch 集群中的所有索引
  • 获取索引映射
  • 获取索引设置
• 集群管理工具：
  • 获取集群健康状态
  • 获取集群统计信息
• 文档工具：
  • 搜索文档

安装步骤

# 克隆仓库
git clone https://github.com/your-username/opensearch-mcp-server.git
cd opensearch-mcp-server

# 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate  # Windows 系统请使用：.venv\Scripts\activate

# 安装包
pip install uv
uv pip install -e .

配置指南

在项目根目录下创建一个名为 .env 的文件，并添加以下变量：

OPENSEARCH_HOST=https://localhost:9200
OPENSEARCH_USERNAME=xxxx
OPENSEARCH_PASSWORD=xxxx

根据你的 OpenSearch 配置调整这些值。

使用说明（与 Cursor 集成）

启动 MCP 服务器

uv run opensearch-mcp-server --port=<端口>

配置 Cursor 连接

在 Cursor 中配置如下：

{
  "mcpServers": {
    "opensearch": {
      "url": "http://<主机>:<端口>/sse"
    }
  }
}

使用说明（与 Claude Desktop APP 集成）

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
          "--directory",
          "/absolute/path/to/opensearch-mcp-server",
          "run",
          "opensearch-mcp-server"
      ]
    }
  }
}

开发指南

# 安装依赖
uv pip install -e .

# 运行测试
uv run pytest -vv -s test_opensearch.py

许可证信息

MIT