Servidor MCP de Marginalia

Un servidor MCP (Model Context Protocol) que proporciona acceso a Marginalia Search , un motor de búsqueda centrado en encontrar contenido no comercial y joyas ocultas de Internet.

Características

Busque en la web utilizando la API de búsqueda de Marginalia
Parámetros de búsqueda configurables, incluidos índice y recuento de resultados
Protección de limitación de velocidad con mensajes de error útiles
Creado con el SDK de MCP para una integración perfecta

Related MCP server: SearXNG MCP Server

Instalación

npm install
npm run build

Configuración

El servidor se puede configurar mediante variables de entorno:

MARGINALIA_API_KEY : Su clave API de búsqueda de Marginalia (opcional, el acceso público es predeterminado)

Para solicitar una clave API dedicada, comuníquese con: kontakt@marginalia.nu

Uso

El servidor proporciona la siguiente herramienta MCP:

buscar

Busca en la web usando Marginalia Busca con los siguientes parámetros:

query (obligatoria): cadena de consulta de búsqueda
index (opcional): Número de índice de búsqueda (corresponde al menú desplegable en la GUI principal)
count (opcional): Número de resultados a devolver (1-100, predeterminado: 10)

Ejemplo de uso a través de MCP:

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

Formato de respuesta

Los resultados de la búsqueda se devuelven en el siguiente formato:

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

Manejo de errores

El servidor incluye un manejo robusto de errores para:

Limitación de velocidad (503 respuestas)
Solicitudes no válidas
Errores de red
Errores específicos de la API

Agregar compatibilidad con texto a voz

Para habilitar las capacidades de conversión de texto a voz mediante el servidor MCP, agregue la siguiente configuración:

Para Cline (extensión de VSCode)

Agregar a ~/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

Agregar a ~/Library/Application Support/Claude/claude_desktop_config.json :

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

El servidor MCP ofrece funciones de conversión de texto a voz con múltiples voces e idiomas. Herramientas disponibles: