Marginalia Search

Servidor MCP de Marginalia

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

Características

• Busca en la web usando la API de Marginalia Search
• Parámetros de búsqueda configurables, incluyendo índice y número de resultados
• Protección contra límites de velocidad con mensajes de error útiles
• Construido con el SDK de MCP para una integración perfecta

Instalación

npm install
npm run build

Configuración

El servidor se puede configurar usando variables de entorno:

• MARGINALIA_API_KEY: Tu clave de API de Marginalia Search (opcional, por defecto usa acceso público)

Para solicitar una clave de API dedicada, contacta: kontakt@marginalia.nu

Uso

El servidor proporciona la siguiente herramienta MCP:

search

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

• query (obligatorio): Cadena de consulta de búsqueda
• index (opcional): Número de índice de búsqueda (corresponde al menú desplegable en la interfaz principal)
• count (opcional): Número de resultados a devolver (1-100, por defecto: 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 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:

• Límites de velocidad (respuestas 503)
• Solicitudes inválidas
• Errores de red
• Errores específicos de la API

Añadir Soporte de Texto a Voz

Para habilitar capacidades de texto a voz usando el servidor MCP say, añade la siguiente configuración:

Para Cline (Extensión de VSCode)

Añade 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

Añade 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 say proporciona capacidades de texto a voz con múltiples voces e idiomas. Herramientas disponibles:

• speak: Lee texto en voz alta usando la voz y velocidad especificadas
• list_voices: Lista todas las voces de texto a voz disponibles

Licencia

Licencia MIT - Consulta el archivo LICENSE para más detalles