Raindrop MCP Server

Servidor MCP Raindrop

Este es un servidor de Protocolo de Contexto de Modelo (MCP) para Raindrop.io, impulsado por el SDK de MCP de Python . Proporciona una manera sencilla de leer y actualizar tus colecciones de Raindrop, así como las gotas de lluvia y las etiquetas desde Claude Desktop, en un lenguaje sencillo y humano. Se puede combinar con herramientas como el servidor MCP de Firecrawl para optimizar la automatización y la organización de tus colecciones de Raindrop y tu sistema de etiquetado.

Requisitos

• Python 3.12+
• administrador de paquetes uv
• Escritorio de Claude
• Una cuenta Raindrop.io y un token API

Configuración

1. Obtenga un token API de Raindrop

1. Vaya al portal para desarrolladores de Raindrop.io
2. Crear una nueva aplicación
3. Copia tu token de API

2. Establezca su token API

Establezca su token de API Raindrop como una variable de entorno:

1. Crea un archivo .env en el directorio raíz
2. Añadir nueva línea: RAINDROP_TOKEN="your_token_here"

Desarrollo

Para ejecutar el servidor en modo de desarrollo:

Instalación

Para instalar el servidor en Claude Desktop:

Esto iniciará el servidor localmente y le permitirá probar los cambios.

Características

El servidor proporciona:

• Acceso a sus colecciones de Raindrop y datos de Raindrop a través de capacidades
• Soporte para visualizar colecciones raíz, colecciones secundarias o una colección específica por ID
• Herramientas para crear, actualizar y eliminar colecciones y gotas de lluvia
• Herramientas para crear y actualizar nuevas etiquetas

Herramientas

El servidor proporciona las siguientes herramientas MCP que permiten a Claude Desktop realizar acciones en sus colecciones Raindrop:

crear_colección

Crea una nueva colección en Raindrop.io.

Parámetros:

• title (obligatorio): Nombre de la colección
• view : Tipo de vista (lista, cuadrícula, mampostería, simple)
• public : si la colección es pública
• parent_id : ID de la colección principal (omitir para la colección raíz)

actualizar_colección

Actualiza una colección existente en Raindrop.io.

Parámetros:

• collection_id (obligatorio): ID de la colección a actualizar
• title : Nuevo nombre para la colección
• view : Tipo de vista (lista, cuadrícula, mampostería, simple)
• public : si la colección es pública
• parent_id : ID de la colección principal (omitir para la colección raíz)
• expanded : Si la colección está expandida

eliminar_colección

Elimina una colección de Raindrop.io. Las gotas de lluvia se moverán a la Papelera.

Parámetros:

• collection_id (obligatorio): ID de la colección a eliminar

vaciar_papelera

Vacía la papelera en Raindrop.io, eliminando permanentemente todas las gotas de lluvia que contiene.

obtener_gota de lluvia

Obtiene una sola gota de lluvia de Raindrop.io por ID.

Parámetros:

• raindrop_id (obligatorio): ID de la gota de lluvia a buscar

obtener_gotas de lluvia

Obtiene múltiples gotas de lluvia de una colección Raindrop.io.

Parámetros:

• collection_id (obligatorio): ID de la colección de la que se obtendrán las gotas de lluvia. Use 0 para todas las gotas de lluvia, -1 para las que no están ordenadas y -99 para las que no están ordenadas.
• search : consulta de búsqueda opcional
• sort : Orden de clasificación (opciones: -creado, creado, puntuación, -ordenar, título, -título, dominio, -dominio)
• page : Número de página (empezando desde 0)
• perpage : Elementos por página (máximo 50)
• nested : si se deben incluir gotas de lluvia de colecciones anidadas

obtener_etiquetas

Obtiene etiquetas de Raindrop.io.

Parámetros:

• collection_id : ID opcional de la colección de la que se obtendrán las etiquetas. Si no se especifica, se recuperarán todas las etiquetas de todas las colecciones.

actualización_gota de lluvia

Actualiza una gota de lluvia (marcador) existente en Raindrop.io.

Parámetros:

• raindrop_id (obligatorio): ID de la gota de lluvia a actualizar
• title : Nuevo título para la gota de lluvia.
• excerpt : Nueva descripción/extracto
• link : Nueva URL
• important : Establecer como Verdadero para marcar como favorito
• tags : Lista de etiquetas para asignar
• collection_id : ID de la colección a la que mover la gota de lluvia
• cover : URL de la imagen de portada
• type : Tipo de gota de lluvia
• order : Orden de clasificación (ascendente): configúrelo en 0 para pasar al primer lugar
• pleaseParse : Establézcalo en Verdadero para volver a analizar los metadatos (portada, tipo) en segundo plano

actualizar_muchas_gotas_de_lluvia

Actualiza varias gotas de lluvia a la vez dentro de una colección.

Parámetros:

• collection_id (obligatorio): ID de la colección que contiene las gotas de lluvia para actualizar
• ids : Lista opcional de identificaciones de gotas de lluvia específicas para actualizar
• important : Establezca en Verdadero para marcar como favorito, Falso para desmarcar
• tags : Lista de etiquetas para agregar (o lista vacía para eliminar todas las etiquetas)
• cover : URL para la imagen de portada (use '' para configurar capturas de pantalla para todos)
• target_collection_id : ID de la colección a la que se moverán las gotas de lluvia
• nested : incluye gotas de lluvia de colecciones anidadas
• search : consulta de búsqueda opcional para filtrar qué gotas de lluvia actualizar

Consultas de ejemplo

Después de instalar el servidor en Claude Desktop, puedes hacerle preguntas y comandos a Claude como:

• "Muéstrame todas mis colecciones de Raindrop"
• ¿Tengo alguna colección relacionada con la programación?
• Añade esta etiqueta a todas las gotas de lluvia de esta colección.
• "Muéstrame los detalles de mi colección Raindrop con ID 12345"
• "¿Qué colecciones secundarias tengo en Raindrop?"
• "Crea una nueva colección Raindrop llamada 'Recursos de Claude'"

Dependencias

Consulte pyproject.toml para conocer las dependencias.

Estos se instalarán automáticamente al utilizar uv run mcp install o uv run mcp dev .

Contribuyendo

¡Agradecemos sus contribuciones! Aquí le mostramos cómo contribuir a este proyecto:

1. Bifurcar el repositorio
2. Crea una nueva rama ( git checkout -b feature/your-feature-name )
3. Realiza tus cambios
4. Validar que funcionen según lo previsto
5. Confirme sus cambios ( git commit -m 'Add some feature' )
6. Empujar a la rama ( git push origin feature/your-feature-name )
7. Abrir una solicitud de extracción

Asegúrese de que su código siga el estilo existente e incluya la documentación adecuada.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo LICENSE.txt para obtener más detalles.