Raindrop.io

Сервер MCP Raindrop.io

Этот проект предоставляет сервер Model Context Protocol (MCP) для взаимодействия с сервисом закладок Raindrop.io . Он позволяет языковым моделям (LLM) и другим агентам ИИ получать доступ к вашим данным Raindrop.io и управлять ими через стандарт MCP.

Функции

Операции CRUD : создание, чтение, обновление и удаление коллекций и закладок.
Расширенный поиск : фильтрация закладок по различным критериям, таким как теги, домен, тип, дата создания и т. д.
Управление тегами : составление списка, переименование, объединение и удаление тегов.
Доступ к выделенному тексту : извлечение выделенных фрагментов текста из закладок.
Управление коллекциями : изменение порядка, разворачивание/сворачивание, объединение и удаление пустых коллекций.
Загрузка файлов : загружайте файлы напрямую на Raindrop.io.
Напоминания : установите напоминания для определенных закладок.
Импорт/Экспорт : инициирование и проверка статуса импорта и экспорта закладок.
Управление корзиной : очистите корзину.
Соответствие MCP : раскрывает функциональные возможности Raindrop.io как ресурсы и инструменты MCP.
Поддержка потоковой передачи : предоставляет конечные точки SSE (Server-Sent Events) в режиме реального времени для потоковых обновлений закладок.
Разработано с использованием TypeScript : строгая типизация для удобства поддержки.
Использует Axios : для выполнения запросов к API Raindrop.io.
Использует Zod : для надежной проверки схемы параметров и ответов API.
Использует MCP SDK : использует официальный @modelcontextprotocol/sdk .

Предпосылки

Node.js (рекомендуется v18 или более поздняя версия) или Bun
Аккаунт Raindrop.io
Токен доступа к API Raindrop.io (создайте его в настройках Raindrop.io )

Установка и использование

Использование NPX (рекомендуется)

Вы можете запустить сервер напрямую с помощью npx, не устанавливая его:

# Set your API token as an environment variable
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN

# Run the server
npx @adeze/raindrop-mcp

Из источника

Клонируйте репозиторий:
git clone https://github.com/adeze/raindrop-mcp.git cd raindrop-mcp
Установить зависимости:
bun install
Настройте переменные среды: создайте файл .env в корневом каталоге, скопировав пример:
cp .env.example .env
Отредактируйте файл .env и добавьте свой токен доступа API Raindrop.io:
RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
Сборка и запуск:
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 для определений ресурсов и инструментов.

Конфигурация МКП

Чтобы использовать сервер Raindrop MCP с вашим помощником на базе искусственного интеллекта или клиентом, совместимым с MCP, вы можете добавить следующую конфигурацию в файл .mcp.json :

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

Для Claude Code или других MCP-совместимых клиентов это зарегистрирует сервер Raindrop под именем «raindrop» и сделает все его ресурсы и инструменты доступными для вашего ИИ-помощника.

Разработка

Тестирование: bun test
Проверка типа: bun run type-check
Сборка: bun run build
Разработка: bun run dev
Отладка: bun run debug или bun run inspector
HTTP-сервер: bun run start:http

Внося вклад

Вклады приветствуются! Пожалуйста, откройте тему или отправьте запрос на извлечение.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

View all tools

Сервер MCP для доступа к менеджеру закладок Raindrop.io.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Notes Server
truaxki
A
security
A
license
A
quality
An MCP server for managing and persisting notes, offering CRUD operations, note summarization, and resource-based access via a note:// URI scheme.
Last updated -
4
6
Python
MIT License
Weather Service MCP Server
Sunwood-ai-labs
-
security
F
license
-
quality
A simple note-taking MCP server that allows storing and summarizing notes with custom URI schemes and provides functionality to add notes and generate summaries with different detail levels.
Last updated -
5
Python
Raindrop MCP Server
ddltn
-
security
A
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
Backlinks MCP
cnych
-
security
-
license
-
quality
A MCP server for retrieving backlink information for any domain(SEO).
Last updated -
1
Python
MIT License

View all related MCP servers