Servidor MCP del lector

Descripción general

Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra a la perfección con su biblioteca Readwise Reader . Este servidor permite que clientes compatibles con MCP, como Claude y VS Code, interactúen con su biblioteca Reader, ofreciendo funciones para el listado, la recuperación y la actualización de documentos. Actúa como puente entre los clientes MCP y su repositorio personal de conocimiento en Readwise Reader.

Related MCP server: MCP Fetch

Componentes

Herramientas

• list_documents

  • Enumere documentos de Reader con filtrado y paginación flexibles.

  • Aporte:

    • location (cadena, opcional): Carpeta por la que se filtrará. Una de las siguientes: new , later , shortlist , archive , feed .

    • updatedAfter (cadena, opcional): solo devuelve los documentos actualizados después de esta marca de tiempo ISO8601.

    • withContent (booleano, opcional): si es verdadero, incluye contenido HTML en los resultados (valor predeterminado: falso).

    • pageCursor (cadena, opcional): cursor de paginación para buscar la página siguiente.

  • Devoluciones:

    • Objeto JSON con una lista de documentos, cada uno de los cuales incluye metadatos y (opcionalmente) contenido, además de información de paginación.

Uso con clientes MCP

Claude Desktop / VS Code / Otros clientes MCP

Para utilizar este servidor con Claude Desktop, VS Code o cualquier cliente compatible con MCP, agregue la siguiente configuración a la configuración de su cliente (por ejemplo, claude_desktop_config.json o .vscode/mcp.json ):

uv (servidor local)

{
  "mcpServers": {
    "reader": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/your/reader/server",
        "run",
        "main.py"
      ],
      "env": {
        "ACCESS_TOKEN": "your_readwise_access_token"
      }
    }
  }
}

• Reemplace /absolute/path/to/your/reader/server con la ruta real a este directorio del proyecto.

• Reemplace your_readwise_access_token con su token de acceso real a la API de Readwise Reader.

• Alternativamente, puede especificar ACCESS_TOKEN en un archivo .env ubicado en el directorio del proyecto.

Para obtener más información, consulte la documentación de la API de Readwise Reader y la documentación de MCP .