Servidor MCP de OpenSearch

Descripción general

Este repositorio es una bifurcación de elastic-mcp-server y se convirtió al servidor MCP de opensearch-mcp-server . Es una implementación del servidor del Protocolo de Contexto de Modelo (MCP) que permite la interacción con Opensearch. Este servidor permite buscar documentos, analizar índices y gestionar clústeres mediante un conjunto de herramientas.

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que permite la interacción con Opensearch. Este servidor permite buscar documentos, analizar índices y gestionar clústeres mediante un conjunto de herramientas.

Características

Operaciones de índice

list_indices : enumera todos los índices del clúster Opensearch.
get_mapping : recupera la configuración de mapeo para un índice específico.
get_settings : obtiene la configuración de ajustes para un índice específico.

Operaciones de documentos

search_documents : busca documentos en un índice utilizando Opensearch Query DSL.

Operaciones de clúster

get_cluster_health : obtiene el estado de salud del clúster.
get_cluster_stats : obtiene información estadística sobre el clúster.

Iniciar clúster de Opensearch

Inicie el clúster Opensearch usando Docker Compose:

docker-compose up -d

Esto iniciará un clúster de Opensearch de 3 nodos y Kibana. El nombre de usuario predeterminado de Opensearch opensearch y la contraseña test123 .

Puedes acceder a Kibana desde http://localhost:5601 .

Uso con Claude Desktop

Uso de uv con desarrollo local

Usar uv requiere clonar el repositorio localmente y especificar la ruta al código fuente. Agregue la siguiente configuración al archivo de configuración de Claude Desktop: claude_desktop_config.json .

Debes cambiar path/to/src/opensearch_mcp_server a la ruta donde clonaste el repositorio.

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

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

Reinicie Claude Desktop para cargar el nuevo servidor MCP.

Ahora puedes interactuar con tu clúster Opensearch a través de Claude usando comandos de lenguaje natural como:

"Enumerar todos los índices del clúster"
"¿Qué edad tiene el estudiante Bob?"
"Muéstrame el estado de salud del clúster"

Licencia

Este proyecto está licenciado bajo la licencia Apache versión 2.0: consulte el archivo de LICENCIA para obtener más detalles.

OpenSearch MCP Server

Integrations