Servidor MCP de búsqueda de Hermes 🔍

🔌 ¡ 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 que los sistemas de IA interactúen sin problemas con diversas fuentes de datos y herramientas, lo que facilita conexiones bidireccionales seguras.

El servidor MCP de Hermes Search proporciona:

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

Prerrequisitos 🔧

Antes de comenzar, asegúrese de tener:

Servicio y credenciales de Azure Cognitive Search
Escritorio o cursor de Claude
Node.js (v20 o superior)
Git instalado (solo es necesario si se utiliza el método de instalación Git)

Instalación del servidor MCP de Hermes Search ⚡

Corriendo con NPX

npx -y hermes-search-mcp@latest

Instalación mediante herrería

Para instalar Hermes Search MCP Server para Claude Desktop automáticamente a través de Smithery:

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

Configuración de clientes MCP ⚙️

Configurando Cline 🤖

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

Abrir Cline en VS Code
Haga clic en el icono de Cline en la barra lateral
Vaya a la pestaña "Servidores MCP" (4 cuadrados)
Busca "Hermes Search" y haz clic en "instalar".
Cuando se le solicite, ingrese sus credenciales de Azure Cognitive Search

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

Abra el archivo de configuración de Cline MCP:

# 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

Agregue la configuración del servidor de búsqueda Hermes 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": []
    }
  }
}

Guarde el archivo y reinicie Cline si ya está ejecutándose.

Configurando el cursor 🖥️

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

Para configurar el servidor Hermes Search MCP en Cursor:

Abrir configuración del cursor
Vaya a Características > Servidores MCP
Haga clic en el botón "+ Agregar nuevo servidor MCP"
Complete la siguiente información:
- Nombre : Ingrese un apodo para el servidor (por ejemplo, "hermes-search-mcp")
- Tipo : Seleccione "comando" como tipo
- Comando : Ingrese el comando para ejecutar el servidor: GXP5
  Importante : reemplace las variables de entorno con sus credenciales de Azure Cognitive Search

Configurando 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

Agregue la configuración del servidor de búsqueda Hermes:

{
  "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 de escritorio Claude 🎯

Una vez completada la instalación y configurada la aplicación de escritorio de Claude, debe cerrarla por completo y volver a abrirla para ver el servidor hermes-search-mcp. Debería ver un icono de búsqueda en la esquina inferior izquierda de la aplicación, que indica las herramientas MCP disponibles.

Ejemplos de búsqueda de Hermes

Buscar documentos :

Search for documents containing "machine learning" in the Azure Cognitive Search index, returning the top 10 results.

Índice Contenido :

Index the following documents into Azure Cognitive Search: [{"id": "1", "title": "AI Overview", "content": "Artificial Intelligence is..."}]

Eliminar índice :

Delete the current Azure Cognitive Search index.

Solución de problemas 🛠️

Problemas comunes

Servidor no encontrado
- Verifique la instalación de npm ejecutando npm --version
- Compruebe la sintaxis de configuración de Claude Desktop
- Asegúrese de que Node.js esté instalado correctamente ejecutando node --version
Problemas con las credenciales de Azure Search
- Confirme que sus credenciales de Azure Cognitive Search sean válidas
- Compruebe que las credenciales estén configuradas correctamente en la configuración.
- Verifique que no haya espacios ni comillas alrededor de las credenciales
Problemas de acceso al índice
- Verifique que el índice exista en su servicio Azure Cognitive Search
- Comprobar los permisos del índice
- Asegúrese de que la clave API tenga los derechos de acceso adecuados

Agradecimientos ✨

Protocolo de contexto de modelo para la especificación MCP
Antrópico para Claude Desktop
Microsoft Azure para búsqueda cognitiva