OpenSearch MCP Server

概述

这是一个从elastic-mcp-server分叉并转换为opensearch-mcp-server的Model Context Protocol (MCP)服务器实现。它提供了与OpenSearch交互的功能。通过一系列工具，该服务器能够搜索文档、分析索引以及管理集群。

一个提供OpenSearch交互的Model Context Protocol (MCP)服务器实现。此服务器通过一系列工具实现了文档搜索、索引分析和集群管理功能。

特性

索引操作

• list_indices: 列出OpenSearch集群中的所有索引。
• get_mapping: 获取特定索引的映射配置。
• get_settings: 获取特定索引的设置配置。

文档操作

• search_documents: 使用OpenSearch查询DSL在索引中搜索文档。

集群操作

• get_cluster_health: 获取集群的健康状态。
• get_cluster_stats: 获取关于集群的统计信息。

启动OpenSearch集群

使用Docker Compose启动OpenSearch集群：

docker-compose up -d

这将启动一个3节点的OpenSearch集群和Kibana。默认的OpenSearch用户名是opensearch，密码是test123。

你可以通过http://localhost:5601访问Kibana。

在Claude Desktop上的使用

使用uv进行本地开发

使用uv需要先将仓库克隆到本地，并指定源代码的路径。在Claude Desktop的配置文件claude_desktop_config.json中添加以下配置。

你需要将path/to/src/opensearch_mcp_server替换为你克隆仓库的实际路径。

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/opensearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "opensearch",
        "OPENSEARCH_PASSWORD": "test123",
        "DASHBOARDS_HOST": "https://localhost:5601"
      }
    }
  }
}

• 在macOS上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在Windows上：%APPDATA%/Claude/claude_desktop_config.json

重启Claude Desktop以加载新的MCP服务器。

现在你可以通过Claude使用自然语言命令与你的OpenSearch集群进行交互，例如：

• "列出集群中的所有索引"
• "Bob学生的年龄是多少？"
• "显示集群健康状态"

许可证

本项目根据Apache License Version 2.0许可发布 - 详情见LICENSE文件。