mcpField
O
OpenSearch MCP Server

OpenSearch MCP Server

本地服务
github.com/loupipalien数据库078 周前更新
代码仓库

关于 OpenSearch MCP Server

OpenSearch MCP Server 让用户通过 MCP 客户端以自然语言操作 OpenSearch 集群，工具涵盖集群状态、索引、文档和查询 DSL 搜索。

主要功能

  1. 01查看集群健康状态和统计信息
  2. 02列出和管理索引
  3. 03批量写入文档操作
  4. 04获取文档
  5. 05使用查询 DSL 搜索

适用场景

  1. 01检查集群健康状态和统计信息
  2. 02创建或删除索引
  3. 03向索引批量写入文档
  4. 04使用查询 DSL 搜索已索引文档

MCP 相关

它向 MCP 客户端提供操作 OpenSearch 集群的工具，包括集群、索引、文档和搜索操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "opensearch-mcp-server-loupipalien": {
      "command": "uvx",
      "args": [
        "git+https://github.com/loupipalien/opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "<OPENSEARCH_HOSTS>",
        "OPENSEARCH_USERNAME": "<OPENSEARCH_USERNAME>",
        "OPENSEARCH_PASSWORD": "<OPENSEARCH_PASSWORD>"
      }
    }
  }
}
启动命令uvx 'git+https://github.com/loupipalien/opensearch-mcp-server'
需要配置的环境变量
OPENSEARCH_HOSTS
OPENSEARCH_USERNAME
OPENSEARCH_PASSWORD密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypigit+https://github.com/loupipalien/opensearch-mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

OpenSearch MCP 服务

通过模型上下文协议（MCP），可直接从任何 MCP 客户端（如 Cursor、Cline）使用自然语言与 OpenSearch 集群交互。
此服务通过一组工具提供分析集群健康状态、向索引批量写入文档、获取索引映射、搜索文档等功能。

工具

集群
  • opensearch_cluster_health：获取集群健康状态
  • opensearch_cluster_stats：获取集群统计信息
文档
  • opensearch_bulk：使用批量操作写入多个文档
  • opensearch_get_document：从索引获取文档
索引
  • opensearch_list_indices：列出集群中的索引
  • opensearch_create_index：使用指定配置创建索引
  • opensearch_delete_index：按索引名称删除索引
  • opensearch_get_index：获取索引信息
搜索
  • opensearch_search：使用提供的查询 DSL 查询索引

先决条件

使用此 MCP 服务前，需要安装以下组件：

  • Python 3.10 或更高版本
  • 已安装 uv

用法

选择以下任一配置，添加到 MCP 设置文件中。然后在 MCP 服务配置中设置 OpenSearch 集群主机（多个主机时以逗号分隔）、用户名和密码。

使用远程仓库运行
{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/loupipalien/opensearch-mcp-server",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "your_opensearch_cluster_hosts",
        "OPENSEARCH_USERNAME": "your_opensearch_cluster_username",
        "OPENSEARCH_PASSWORD": "your_opensearch_cluster_password"
      }
    }
  }
}
使用本地仓库运行
{
  "mcpServers": {
    "opensearch-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/repo/src/opensearch_mcp_server",
        "run",
        "server.py"
      ],
      "env": {
        "OPENSEARCH_HOSTS": "your_opensearch_cluster_hosts",
        "OPENSEARCH_USERNAME": "your_opensearch_cluster_username",
        "OPENSEARCH_PASSWORD": "your_opensearch_cluster_password"
      }
    }
  }
}

启动 OpenSearch 集群

如果没有 OpenSearch 集群，可以在本地仓库根目录运行以下命令来启动一个集群。更多详情请参见此处。
这会创建一个包含 2 个节点的集群和一个仪表板。默认用户名为 admin，密码为 your_opensearch_cluster_password。可以通过 https://localhost:9200 访问集群，并通过 http://localhost:5601 访问仪表板

export OPENSEARCH_INITIAL_ADMIN_PASSWORD=your_opensearch_cluster_password

docker-compose up -d

停止集群和仪表板

docker-compose down -v

许可证

此项目采用 Apache v2.0 许可证。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。