Marginalia Search

Servidor MCP Marginalia

Um servidor MCP (Model Context Protocol) que fornece acesso ao Marginalia Search, um mecanismo de busca focado em encontrar conteúdo não comercial e joias escondidas da internet.

Recursos

• Pesquise na web usando a API do Marginalia Search
• Parâmetros de busca configuráveis, incluindo índice e número de resultados
• Proteção contra limite de taxa com mensagens de erro úteis
• Construído usando o SDK MCP para integração perfeita

Instalação

npm install
npm run build

Configuração

O servidor pode ser configurado usando variáveis de ambiente:

• MARGINALIA_API_KEY: Sua chave de API do Marginalia Search (opcional, padrão é acesso público)

Para solicitar uma chave de API dedicada, entre em contato: kontakt@marginalia.nu

Uso

O servidor fornece a seguinte ferramenta MCP:

search

Pesquise na web usando o Marginalia Search com os seguintes parâmetros:

• query (obrigatório): String de consulta de busca
• index (opcional): Número do índice de busca (corresponde ao menu suspenso na interface gráfica principal)
• count (opcional): Número de resultados a retornar (1-100, padrão: 10)

Exemplo de uso através do MCP:

const result = await mcp.useTool("marginalia", "search", {
  query: "interesting non-commercial websites",
  count: 5
});

Formato de Resposta

Os resultados da busca são retornados no seguinte formato:

{
  "query": "your search query",
  "license": "license information",
  "results": [
    {
      "url": "result url",
      "title": "page title",
      "description": "page description"
    }
    // ... more results
  ]
}

Tratamento de Erros

O servidor inclui tratamento robusto de erros para:

• Limite de taxa (respostas 503)
• Requisições inválidas
• Erros de rede
• Erros específicos da API

Adicionando Suporte a Texto para Fala

Para habilitar recursos de texto para fala usando o servidor MCP say, adicione a seguinte configuração:

Para Cline (Extensão do VSCode)

Adicione ao ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": ["/Users/barton/worlds/servers/src/say-mcp-server/build/index.js"]
    }
  }
}

Para Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "say": {
      "command": "node",
      "args": ["/Users/barton/worlds/servers/src/say-mcp-server/build/index.js"]
    }
  }
}

O servidor MCP say fornece recursos de texto para fala com múltiplas vozes e idiomas. Ferramentas disponíveis:

• speak: Leia texto em voz alta usando voz e velocidade especificadas
• list_voices: Liste todas as vozes de texto para fala disponíveis

Licença

Licença MIT - Consulte o arquivo LICENSE para detalhes