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

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

2. Establezca su token API

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

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

Desarrollo

Para ejecutar el servidor en modo de desarrollo:

uv run mcp dev server.py

Instalación

Para instalar el servidor en Claude Desktop:

uv run mcp install server.py

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:

Bifurcar el repositorio
Crea una nueva rama ( git checkout -b feature/your-feature-name )
Realiza tus cambios
Validar que funcionen según lo previsto
Confirme sus cambios ( git commit -m 'Add some feature' )
Empujar a la rama ( git push origin feature/your-feature-name )
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.