Raindrop MCP 서버

Python MCP SDK를 기반으로 하는 Raindrop.io용 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude Desktop에서 Raindrop 컬렉션, 레인드롭, 태그를 간단한 인간 언어로 쉽게 읽고 업데이트할 수 있는 방법을 제공합니다. Firecrawl MCP 서버 등과 함께 사용하면 Raindrop 컬렉션 및 태그 지정 시스템의 간소화된 자동화 및 구성이 가능합니다.

요구 사항

파이썬 3.12+
uv 패키지 관리자
클로드 데스크탑
Raindrop.io 계정 및 API 토큰

설정

1. Raindrop API 토큰 획득

Raindrop.io 개발자 포털 로 이동
새로운 앱을 만드세요
API 토큰을 복사하세요

2. API 토큰 설정

Raindrop API 토큰을 환경 변수로 설정하세요.

루트 디렉토리에 .env 파일을 만듭니다.
새 줄을 추가합니다: RAINDROP_TOKEN="your_token_here"

개발

개발 모드에서 서버를 실행하려면:

지엑스피1

설치

Claude Desktop에 서버를 설치하려면:

uv run mcp install server.py

이렇게 하면 서버가 로컬로 시작되어 변경 사항을 테스트할 수 있습니다.

특징

서버는 다음을 제공합니다.

기능을 통해 Raindrop 컬렉션 및 Raindrop 데이터에 액세스
ID로 루트 컬렉션, 자식 컬렉션 또는 특정 컬렉션 보기 지원
컬렉션 및 빗방울을 만들고, 업데이트하고, 삭제하는 도구
새로운 태그를 생성하고 업데이트하는 도구

도구

이 서버는 Claude Desktop이 Raindrop 컬렉션에 대한 작업을 수행할 수 있도록 다음과 같은 MCP 도구를 제공합니다.

컬렉션 생성

Raindrop.io에 새로운 컬렉션을 만듭니다.

매개변수:

title (필수): 컬렉션의 이름
view : 뷰 유형(리스트, 그리드, 메이슨리, 단순)
public : 컬렉션이 공개인지 여부
parent_id : 부모 컬렉션의 ID(루트 컬렉션의 경우 생략)

업데이트_수집

Raindrop.io의 기존 컬렉션을 업데이트합니다.

매개변수:

collection_id (필수): 업데이트할 컬렉션의 ID
title : 컬렉션의 새 이름
view : 뷰 유형(리스트, 그리드, 메이슨리, 단순)
public : 컬렉션이 공개인지 여부
parent_id : 부모 컬렉션의 ID(루트 컬렉션의 경우 생략)
expanded : 컬렉션이 확장되었는지 여부

컬렉션 삭제

Raindrop.io에서 컬렉션을 삭제합니다. 빗방울은 휴지통으로 이동합니다.

매개변수:

collection_id (필수): 삭제할 컬렉션의 ID

빈 휴지통

Raindrop.io의 휴지통을 비우고, 휴지통에 있는 모든 빗방울을 영구적으로 삭제합니다.

빗방울을 얻으세요

Raindrop.io에서 ID로 빗방울 하나를 가져옵니다.

매개변수:

raindrop_id (필수): 가져올 빗방울의 ID

빗방울을 얻으세요

Raindrop.io 컬렉션에서 여러 개의 빗방울을 가져옵니다.

매개변수:

collection_id (필수): 빗방울을 가져올 컬렉션의 ID입니다. 모든 빗방울을 가져오려면 0, 정렬되지 않은 빗방울을 가져오려면 -1, 휴지통 빗방울을 가져오려면 -99를 사용하세요.
search : 선택 검색어
sort : 정렬 순서 (옵션: -created, created, score, -sort, title, -title, domain, -domain)
page : 페이지 번호(0부터 시작)
perpage : 페이지당 항목 수(최대 50개)
nested : 중첩된 컬렉션에서 빗방울을 포함할지 여부

태그를 얻으세요

Raindrop.io에서 태그를 가져옵니다.

매개변수:

collection_id : 태그를 가져올 컬렉션의 선택적 ID입니다. 지정하지 않으면 모든 컬렉션의 모든 태그가 검색됩니다.

업데이트_레인드롭

Raindrop.io의 기존 레인드롭(북마크)을 업데이트합니다.

매개변수:

raindrop_id (필수): 업데이트할 빗방울의 ID
title : 빗방울의 새로운 제목
excerpt : 새로운 설명/발췌문
link : 새 URL
important : 즐겨찾기로 표시하려면 True로 설정하세요.
tags : 할당할 태그 목록
collection_id : 빗방울을 옮길 컬렉션의 ID
cover : 표지 이미지의 URL
type : 빗방울의 유형
order : 정렬 순서(오름차순) - 0으로 설정하면 첫 번째 위치로 이동합니다.
pleaseParse : True로 설정하면 백그라운드에서 메타데이터(커버, 유형)를 다시 분석합니다.

업데이트_많은_빗방울

컬렉션 내에서 여러 개의 빗방울을 동시에 업데이트합니다.

매개변수:

collection_id (필수): 업데이트할 빗방울이 포함된 컬렉션의 ID
ids : 업데이트할 특정 빗방울 ID의 선택적 목록
important : 즐겨찾기로 표시하려면 True로 설정하고, 표시를 해제하려면 False로 설정합니다.
tags : 추가할 태그 목록(또는 모든 태그를 제거하려면 빈 목록)
cover : 표지 이미지의 URL(모든 표지 이미지의 스크린샷을 설정하려면 ''를 사용하세요)
target_collection_id : 빗방울을 옮길 컬렉션의 ID
nested : 중첩된 컬렉션에서 빗방울을 포함합니다.
search : 업데이트할 빗방울을 필터링하기 위한 선택적 검색 쿼리

예제 쿼리

Claude Desktop에 서버를 설치한 후 Claude에게 다음과 같은 질문과 명령을 내릴 수 있습니다.

"내 모든 Raindrop 컬렉션을 보여줘"
"프로그래밍과 관련된 컬렉션이 있나요?"
"이 태그를 이 컬렉션의 모든 빗방울에 추가하세요"
"ID 12345의 Raindrop 컬렉션에 대한 세부 정보를 보여주세요"
"Raindrop에는 어떤 아동 컬렉션이 있나요?"
"Claude Resources"라는 이름의 새로운 Raindrop 컬렉션을 만드세요.

종속성

종속성에 대해서는 pyproject.toml 참조하세요.

uv run mcp install 또는 uv run mcp dev 사용하면 이러한 항목이 자동으로 설치됩니다.

기여하다

참여를 환영합니다! 이 프로젝트에 기여하는 방법은 다음과 같습니다.

저장소를 포크하세요
새로운 브랜치를 생성합니다( git checkout -b feature/your-feature-name )
변경 사항을 만드세요
의도한 대로 작동하는지 확인하세요
변경 사항을 커밋합니다( git commit -m 'Add some feature' )
브랜치에 푸시합니다( git push origin feature/your-feature-name )
풀 리퀘스트 열기

귀하의 코드가 기존 스타일을 따르고 적절한 문서를 포함하고 있는지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE.txt 파일을 참조하세요.