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, не устанавливая его:

Из источника

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

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

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

Для 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 .