Сервер 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 .