OpenSearch MCP 服务器

用于 OpenSearch 集成的 MCP (模型上下文协议) 服务器，其灵感来源于 elasticsearch-mcp-server。

功能

• 索引管理工具:
  • 列出 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=<port>

与 Cursor 集成

{
  "mcpServers": {
    "opensearch": {
      "url": "http://<host>:<port>>/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