OpenSearch MCP Server

OpenSearch MCP Server

Visão Geral

Este repositório é um fork do elastic-mcp-server e convertido para o servidor MCP opensearch-mcp-server. É uma implementação de servidor Model Context Protocol (MCP) que fornece interação com o OpenSearch. Este servidor permite pesquisar documentos, analisar índices e gerenciar o cluster por meio de um conjunto de ferramentas.

Uma implementação de servidor Model Context Protocol (MCP) que fornece interação com o OpenSearch. Este servidor permite pesquisar documentos, analisar índices e gerenciar o cluster por meio de um conjunto de ferramentas.

Recursos

Operações de Índice

• list_indices: Listar todos os índices no cluster Opensearch.
• get_mapping: Recuperar a configuração de mapeamento de um índice específico.
• get_settings: Obter a configuração de configurações de um índice específico.

Operações de Documento

• search_documents: Pesquisar documentos em um índice usando o Opensearch Query DSL.

Operações de Cluster

• get_cluster_health: Obter o status de saúde do cluster.
• get_cluster_stats: Obter informações estatísticas sobre o cluster.

Iniciar o Cluster Opensearch

Inicie o cluster Opensearch usando Docker Compose:

docker-compose up -d

Isso iniciará um cluster Opensearch de 3 nós e o Kibana. Usuário padrão do Opensearch opensearch, senha test123.

Você pode acessar o Kibana em http://localhost:5601.

Uso com Claude Desktop

Usando uv com desenvolvimento local

Usar o uv requer clonar o repositório localmente e especificar o caminho para o código-fonte. Adicione a seguinte configuração ao arquivo de configuração do Claude Desktop claude_desktop_config.json.

você precisa alterar path/to/src/opensearch_mcp_server para o caminho onde você clonou o repositório.

{
  "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"
      }
    }
  }
}

• No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• No Windows: %APPDATA%/Claude/claude_desktop_config.json

Reinicie o Claude Desktop para carregar o novo servidor MCP.

Agora você pode interagir com seu cluster Opensearch por meio do Claude usando comandos em linguagem natural, como:

• "Listar todos os índices no cluster"
• "Qual a idade do estudante Bob?"
• "Mostre-me o status de saúde do cluster"

Licença

Este projeto é licenciado sob a Apache License Versão 2.0 - consulte o arquivo LICENSE para obter detalhes.