Hermes Search

Proporciona búsqueda de texto completo y semántica sobre datos estructurados y no estructurados utilizando Azure Cognitive Search.

GitHub
4
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Hermes Search 🔍

🔌 Compatible con Cline, Cursor, Claude Desktop y cualquier otro cliente MCP.

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los sistemas de IA interactuar sin problemas con diversas fuentes de datos y herramientas, facilitando conexiones seguras y bidireccionales.

El servidor MCP de Hermes Search proporciona:

  • Capacidades de búsqueda de texto completo y semántica sobre datos estructurados y no estructurados
  • Indexación y gestión de documentos en Azure Cognitive Search
  • Operaciones de búsqueda eficientes con parámetros personalizables
  • Operaciones seguras de tipos con TypeScript

Requisitos previos 🔧

Antes de comenzar, asegúrate de tener:

  • Servicio y credenciales de Azure Cognitive Search
  • Claude Desktop o Cursor
  • Node.js (v20 o superior)
  • Git instalado (solo necesario si se usa el método de instalación mediante Git)

Instalación del servidor MCP de Hermes Search ⚡

Ejecutar con NPX

npx -y hermes-search-mcp@latest

Instalación mediante Smithery

Para instalar el servidor MCP de Hermes Search para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @hermes-search/mcp --client claude

Configuración de clientes MCP ⚙️

Configuración de Cline 🤖

La forma más sencilla de configurar el servidor MCP de Hermes Search en Cline es a través del marketplace con un solo clic:

  1. Abre Cline en VS Code
  2. Haz clic en el icono de Cline en la barra lateral
  3. Navega a la pestaña "Servidores MCP" (4 cuadrados)
  4. Busca "Hermes Search" y haz clic en "instalar"
  5. Cuando se te solicite, introduce tus credenciales de Azure Cognitive Search

Alternativamente, puedes configurar manualmente el servidor MCP de Hermes Search en Cline:

  1. Abre el archivo de configuración MCP de Cline:
# For macOS:
code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# For Windows:
code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  1. Añade la configuración del servidor de Hermes Search al archivo:
{
  "mcpServers": {
    "hermes-search-mcp": {
      "command": "npx",
      "args": ["-y", "hermes-search-mcp@latest"],
      "env": {
        "AZURE_SEARCH_ENDPOINT": "your-search-endpoint",
        "AZURE_SEARCH_API_KEY": "your-api-key",
        "AZURE_SEARCH_INDEX_NAME": "your-index-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  1. Guarda el archivo y reinicia Cline si ya está en ejecución.

Configuración de Cursor 🖥️

Nota: Requiere la versión 0.45.6 o superior de Cursor

Para configurar el servidor MCP de Hermes Search en Cursor:

  1. Abre la Configuración de Cursor
  2. Navega a Funciones > Servidores MCP
  3. Haz clic en el botón "+ Añadir nuevo servidor MCP"
  4. Completa la siguiente información:
    • Nombre: Introduce un apodo para el servidor (por ejemplo, "hermes-search-mcp")
    • Tipo: Selecciona "command" como tipo
    • Comando: Introduce el comando para ejecutar el servidor:
    env AZURE_SEARCH_ENDPOINT=your-search-endpoint AZURE_SEARCH_API_KEY=your-api-key AZURE_SEARCH_INDEX_NAME=your-index-name npx -y hermes-search-mcp@latest

    Importante: Reemplaza las variables de entorno con tus credenciales de Azure Cognitive Search

Configuración de la aplicación Claude Desktop 🖥️

Para macOS:

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Para Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Añade la configuración del servidor de Hermes Search:

{
  "mcpServers": {
    "hermes-search-mcp": {
      "command": "npx",
      "args": ["-y", "hermes-search-mcp@latest"],
      "env": {
        "AZURE_SEARCH_ENDPOINT": "your-search-endpoint",
        "AZURE_SEARCH_API_KEY": "your-api-key",
        "AZURE_SEARCH_INDEX_NAME": "your-index-name"
      }
    }
  }
}

Uso en la aplicación Claude Desktop 🎯

Una vez completada la instalación y configurada la aplicación de escritorio de Claude, debes cerrar y volver a abrir completamente la aplicación de escritorio de Claude para ver el servidor hermes-search-mcp. Deberías ver un icono de búsqueda en la parte inferior izquierda de la aplicación, lo que indica que hay herramientas MCP disponibles.

Ejemplos de Hermes Search

  1. Buscar documentos:
Search for documents containing "machine learning" in the Azure Cognitive Search index, returning the top 10 results.
  1. Indexar contenido:
Index the following documents into Azure Cognitive Search: [{"id": "1", "title": "AI Overview", "content": "Artificial Intelligence is..."}]
  1. Eliminar índice:
Delete the current Azure Cognitive Search index.

Solución de problemas 🛠️

Problemas comunes

  1. Servidor no encontrado

    • Verifica la instalación de npm ejecutando npm --version
    • Comprueba la sintaxis de configuración de Claude Desktop
    • Asegúrate de que Node.js esté instalado correctamente ejecutando node --version

  2. Problemas con las credenciales de Azure Search

    • Confirma que tus credenciales de Azure Cognitive Search son válidas
    • Comprueba que las credenciales estén configuradas correctamente en la configuración
    • Verifica que no haya espacios ni comillas alrededor de las credenciales

  3. Problemas de acceso al índice

    • Verifica que el índice exista en tu servicio de Azure Cognitive Search
    • Comprueba los permisos del índice
    • Asegúrate de que la clave de API tenga los derechos de acceso adecuados

Agradecimientos ✨

  • Protocolo de Contexto de Modelo por la especificación MCP
  • Anthropic por Claude Desktop
  • Microsoft Azure por Cognitive Search