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

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:

speak : Leer un texto en voz alta usando una voz y velocidad específicas.
list_voices : enumera todas las voces de texto a voz disponibles

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles

Marginalia MCP Server