Integrations
Used for environment variable configuration in the Raindrop.io MCP server
Used for making HTTP requests to the Raindrop.io API
Can be used for installing dependencies and running the Raindrop.io MCP server
Raindrop.io MCP 서버
이 프로젝트는 Raindrop.io 북마크 서비스와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다. 이를 통해 언어 모델(LLM) 및 기타 AI 에이전트가 MCP 표준을 통해 Raindrop.io 데이터에 접근하고 관리할 수 있습니다.
특징
- CRUD 작업 : 컬렉션과 북마크를 만들고, 읽고, 업데이트하고, 삭제합니다.
- 고급 검색 : 태그, 도메인, 유형, 생성 날짜 등 다양한 기준으로 북마크를 필터링합니다.
- 태그 관리 : 태그를 나열하고, 이름을 바꾸고, 병합하고, 삭제합니다.
- 하이라이트 액세스 : 북마크에서 텍스트 하이라이트를 검색합니다.
- 컬렉션 관리 : 빈 컬렉션을 재정렬, 확장/축소, 병합 및 제거합니다.
- 파일 업로드 : Raindrop.io에 직접 파일을 업로드합니다.
- 알림 : 특정 북마크에 대한 알림을 설정합니다.
- 가져오기/내보내기 : 북마크 가져오기 및 내보내기 상태를 시작하고 확인합니다.
- 쓰레기 관리 : 쓰레기를 비우세요.
- MCP 규정 준수 : Raindrop.io 기능을 MCP 리소스 및 도구로 공개합니다.
- 스트리밍 지원 : 스트리밍 북마크 업데이트를 위한 실시간 SSE(서버 전송 이벤트) 엔드포인트를 제공합니다.
- TypeScript로 구축 : 더 나은 유지 관리를 위한 강력한 타이핑.
- Axios 사용 : Raindrop.io API에 요청을 보내는 데 사용합니다.
- Zod 사용 : API 매개변수와 응답의 강력한 스키마 검증을 위해.
- MCP SDK 사용 : 공식
@modelcontextprotocol/sdk
활용합니다.
필수 조건
- Node.js(v18 이상 권장) 또는 Bun
- Raindrop.io 계정
- Raindrop.io API 액세스 토큰( Raindrop.io 설정 에서 생성)
설치 및 사용
NPX 사용(권장)
npx를 설치하지 않고도 서버를 직접 실행할 수 있습니다.
지엑스피1
출처에서
- 저장소를 복제합니다.Copy
- 종속성 설치:Copy
- 환경 변수 구성: 다음 예를 복사하여 루트 디렉토리에
.env
파일을 만듭니다.Copy.env
파일을 편집하고 Raindrop.io API 액세스 토큰을 추가하세요.Copy - 빌드 및 실행:Copy
서버는 기본적으로 통신에 표준 입출력(stdio)을 사용하여 stdin에서 요청을 수신하고 stdout으로 응답을 보냅니다.
MCP 클라이언트와 함께 사용
MCP 클라이언트(LLM 에이전트 등)를 stdio를 통해 실행 중인 서버 프로세스에 연결합니다. 서버는 다음과 같은 리소스 URI를 노출합니다.
collections://all
- 모든 컬렉션collections://{parentId}/children
- 자식 컬렉션tags://all
- 모든 태그tags://collection/{collectionId}
- 컬렉션별로 필터링된 태그highlights://all
- 모든 하이라이트highlights://raindrop/{raindropId}
- 특정 북마크에 대한 하이라이트highlights://collection/{collectionId}
- 컬렉션별로 필터링된 하이라이트bookmarks://collection/{collectionId}
- 컬렉션의 북마크bookmarks://raindrop/{id}
- ID별 특정 북마크user://info
- 사용자 정보user://stats
- 사용자 통계
또한 컬렉션 관리, 북마크 작업, 태그 관리, 강조 표시 작업, 사용자 작업 등 운영 작업을 위한 다양한 도구를 제공합니다. 사용 가능한 모든 도구의 자세한 목록은 CLAUDE.md
를 참조하거나 src/services/mcp.service.ts
리소스 및 도구 정의를 확인하세요.
MCP 구성
AI 어시스턴트나 MCP 호환 클라이언트와 함께 Raindrop MCP 서버를 사용하려면 .mcp.json
파일에 다음 구성을 추가하면 됩니다.
Claude Code 또는 다른 MCP 호환 클라이언트의 경우, 이렇게 하면 Raindrop 서버가 "raindrop"이라는 이름으로 등록되고 모든 리소스와 도구가 AI 비서에서 사용 가능하게 됩니다.
개발
- 테스트:
bun test
- 유형 검사:
bun run type-check
- 빌드:
bun run build
- 개발:
bun run dev
- 디버그:
bun run debug
또는bun run inspector
- HTTP 서버:
bun run start:http
기여하다
기여를 환영합니다! 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Raindrop.io 북마크 관리자에 접속하기 위한 MCP 서버입니다.
Related Resources
Related MCP Servers
- -securityAlicense-qualityThis MCP server integrates with Google Drive to allow listing, reading, and searching over files.Last updated -1,49545,356JavaScriptMIT License
pure.md MCP serverofficial
AsecurityFlicenseAqualityAn MCP server that enables AI clients like Cursor, Windsurf, and Claude Desktop to access web content in markdown format, providing web unblocking and searching capabilities.Last updated -21813JavaScript- -security-license-qualityAn MCP server that allows Claude Desktop to access and manage Raindrop.io bookmarks through natural language commands, supporting operations for collections, raindrops, and tags.Last updated -2PythonMIT License