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)

Related MCP server: AXYS MCP Lite

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:

1. Abrir Cline en VS Code

2. Haga clic en el icono de Cline en la barra lateral

3. Vaya a la pestaña "Servidores MCP" (4 cuadrados)

4. Busca "Hermes Search" y haz clic en "instalar".

5. Cuando se le solicite, ingrese sus credenciales de Azure Cognitive Search

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

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

2. 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": []
    }
  }
}

3. 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:

1. Abrir configuración del cursor

2. Vaya a Características > Servidores MCP

3. Haga clic en el botón "+ Agregar nuevo servidor MCP"

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

1. Buscar documentos :

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

2. Índice Contenido :

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

3. Eliminar índice :

Delete the current Azure Cognitive Search index.

Solución de problemas 🛠️

Problemas comunes

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

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

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