Hermes Search

Fornece pesquisa de texto completo e semântica sobre dados estruturados e não estruturados usando o Azure Cognitive Search.

GitHub
4
Experimente este MCPPatrocinado

Documentação

Servidor MCP Hermes Search 🔍

🔌 Compatível com Cline, Cursor, Claude Desktop e qualquer outro cliente MCP!

O Model Context Protocol (MCP) é um padrão aberto que permite que sistemas de IA interajam perfeitamente com várias fontes de dados e ferramentas, facilitando conexões seguras e bidirecionais.

O servidor MCP Hermes Search fornece:

  • Capacidades de pesquisa de texto completo e semântica sobre dados estruturados/não estruturados
  • Indexação e gerenciamento de documentos no Azure Cognitive Search
  • Operações de pesquisa eficientes com parâmetros personalizáveis
  • Operações type-safe com TypeScript

Pré-requisitos 🔧

Antes de começar, certifique-se de ter:

  • Serviço e credenciais do Azure Cognitive Search
  • Claude Desktop ou Cursor
  • Node.js (v20 ou superior)
  • Git instalado (necessário apenas se usar o método de instalação via Git)

Instalação do servidor MCP Hermes Search ⚡

Executando com NPX

npx -y hermes-search-mcp@latest

Instalando via Smithery

Para instalar o servidor MCP Hermes Search para Claude Desktop automaticamente via Smithery:

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

Configurando clientes MCP ⚙️

Configurando o Cline 🤖

A maneira mais fácil de configurar o servidor MCP Hermes Search no Cline é através do marketplace com um único clique:

  1. Abra o Cline no VS Code
  2. Clique no ícone do Cline na barra lateral
  3. Navegue até a aba "MCP Servers" (4 quadrados)
  4. Pesquise "Hermes Search" e clique em "install"
  5. Quando solicitado, insira suas credenciais do Azure Cognitive Search

Alternativamente, você pode configurar manualmente o servidor MCP Hermes Search no Cline:

  1. Abra o arquivo de configurações MCP do 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. Adicione a configuração do servidor Hermes Search ao arquivo:
{
  "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. Salve o arquivo e reinicie o Cline se ele já estiver em execução.

Configurando o Cursor 🖥️

Nota: Requer a versão 0.45.6 ou superior do Cursor

Para configurar o servidor MCP Hermes Search no Cursor:

  1. Abra as Configurações do Cursor
  2. Navegue até Features > MCP Servers
  3. Clique no botão "+ Add New MCP Server"
  4. Preencha as seguintes informações:
    • Nome: Insira um apelido para o servidor (por exemplo, "hermes-search-mcp")
    • Tipo: Selecione "command" como o tipo
    • Comando: Insira o comando para executar o 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: Substitua as variáveis de ambiente pelas suas credenciais do Azure Cognitive Search

Configurando o aplicativo 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

Adicione a configuração do servidor 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 no aplicativo Claude Desktop 🎯

Após a instalação estar completa e o aplicativo Claude Desktop estar configurado, você deve fechar e reabrir completamente o aplicativo Claude Desktop para ver o servidor hermes-search-mcp. Você deve ver um ícone de pesquisa no canto inferior esquerdo do aplicativo, indicando as ferramentas MCP disponíveis.

Exemplos do Hermes Search

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

Solução de problemas 🛠️

Problemas comuns

  1. Servidor não encontrado

    • Verifique a instalação do npm executando npm --version
    • Verifique a sintaxe da configuração do Claude Desktop
    • Certifique-se de que o Node.js esteja instalado corretamente executando node --version

  2. Problemas com credenciais do Azure Search

    • Confirme se suas credenciais do Azure Cognitive Search são válidas
    • Verifique se as credenciais estão configuradas corretamente no arquivo de configuração
    • Verifique se não há espaços ou aspas ao redor das credenciais

  3. Problemas de acesso ao índice

    • Verifique se o índice existe no seu serviço do Azure Cognitive Search
    • Verifique as permissões do índice
    • Garanta que a chave de API tenha os direitos de acesso apropriados

Agradecimentos ✨

  • Model Context Protocol pela especificação MCP
  • Anthropic pelo Claude Desktop
  • Microsoft Azure pelo Cognitive Search