OpenSearch MCP Server

OpenSearch MCP Server

Resumen

Este repositorio es un fork de elastic-mcp-server y convertido a opensearch-mcp-server MCP Server. Es una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona interacción con OpenSearch. Este servidor permite buscar documentos, analizar índices y gestionar el clúster a través de un conjunto de herramientas.

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona interacción con OpenSearch. Este servidor permite buscar documentos, analizar índices y gestionar el clúster a través de un conjunto de herramientas.

Características

Operaciones de Índice

• list_indices: Listar todos los índices en el clúster de OpenSearch.
• get_mapping: Recuperar la configuración de mapeo para un índice específico.
• get_settings: Obtener la configuración de ajustes para un índice específico.

Operaciones de Documentos

• search_documents: Buscar documentos en un índice usando OpenSearch Query DSL.

Operaciones de Clúster

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

Iniciar el Clúster de OpenSearch

Inicie el clúster de OpenSearch usando Docker Compose:

docker-compose up -d

Esto iniciará un clúster de OpenSearch de 3 nodos y Kibana. Nombre de usuario predeterminado de OpenSearch opensearch, contraseña test123.

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

Uso con Claude Desktop

Usando 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.

necesita cambiar path/to/src/opensearch_mcp_server a la ruta donde clonó 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",
        "DASHBOARDS_HOST": "https://localhost:5601"
      }
    }
  }
}

• 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 puede interactuar con su clúster de OpenSearch a través de Claude usando comandos en lenguaje natural como:

• "Listar todos los índices en el 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 LICENSE para más detalles.