Raindrop.io

by adeze

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

출처에서

  1. 저장소를 복제합니다.
    git clone https://github.com/adeze/raindrop-mcp.git cd raindrop-mcp
  2. 종속성 설치:
    bun install
  3. 환경 변수 구성: 다음 예를 복사하여 루트 디렉토리에 .env 파일을 만듭니다.
    cp .env.example .env
    .env 파일을 편집하고 Raindrop.io API 액세스 토큰을 추가하세요.
    RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
  4. 빌드 및 실행:
    bun run build bun start

서버는 기본적으로 통신에 표준 입출력(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 파일에 다음 구성을 추가하면 됩니다.

"raindrop": { "command": "npx", "args": [ "@adeze/raindrop-mcp" ], "env": { "RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_API_TOKEN" } }

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.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

Raindrop.io 북마크 관리자에 접속하기 위한 MCP 서버입니다.

  1. 특징
    1. 필수 조건
      1. 설치 및 사용
        1. NPX 사용(권장)
        2. 출처에서
      2. MCP 클라이언트와 함께 사용
        1. MCP 구성
      3. 개발
        1. 기여하다
          1. 특허

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              This MCP server integrates with Google Drive to allow listing, reading, and searching over files.
              Last updated -
              1,495
              45,356
              JavaScript
              MIT License
            • A
              security
              F
              license
              A
              quality
              An 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 -
              2
              181
              3
              JavaScript
              • Apple
            • -
              security
              -
              license
              -
              quality
              An 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 -
              2
              Python
              MIT License

            View all related MCP servers

            ID: 6h8e8zmap0