OpenSearch MCP Server

Um servidor MCP para interagir com clusters OpenSearch, configurado por meio de variáveis de ambiente.

Documentação

Servidor MCP do OpenSearch

Servidor MCP (Model Context Protocol) para integração com OpenSearch, inspirado no elasticsearch-mcp-server.

Recursos

  • Ferramentas de Gerenciamento de Índices:
    • Listar todos os índices no cluster OpenSearch
    • Obter mapeamento de índice
    • Obter configurações de índice
  • Ferramentas de Gerenciamento de Cluster:
    • Obter status de saúde do cluster
    • Obter estatísticas do cluster
  • Ferramentas de Documentos:
    • Pesquisar documentos

Instalação

# Clone the repository
git clone https://github.com/your-username/opensearch-mcp-server.git
cd opensearch-mcp-server

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install the package
pip install uv
uv pip install -e .

Configuração

Crie um arquivo .env no diretório raiz com as seguintes variáveis:

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

Ajuste os valores para corresponder à sua configuração do OpenSearch.

Uso com Cursor

Execute o servidor MCP:

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

Integre com o Cursor

{
  "mcpServers": {
    "opensearch": {
      "url": "http://<host>:<port>>/sse"
    }
  }
}

Uso com o Aplicativo Claude Desktop

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

Desenvolvimento

# Install dependencies
uv pip install -e .

# Run tests
uv run pytest -vv -s test_opensearch.py

Licença

MIT