Ищите закладки в Raindrop.io, просматривайте коллекции и создавайте планы по организации данных с помощью AI агентов.
Также известен как KingPsychopath/raindrop-cli, raindrop-cli, @machineyearn/raindrop-cli
- Звёзды
- 2
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 0.2.1
- Последний коммит
- 3 нояб. 2026 г.
- Лицензия
- MIT
Что такое rdrop MCP?
rdrop — это MCP server. Ищите закладки в Raindrop.io, просматривайте коллекции и создавайте планы по организации данных с помощью AI агентов.
Сводка сгенерирована из README проекта
О rdrop MCP server
rdrop для Raindrop.io предоставляет способ управления, поиска и организации вашей библиотеки закладок Raindrop.io с помощью инструментов командной строки или AI агентов. Он работает как нативный Go CLI и MCP server, который позволяет просматривать коллекции, находить возможности для очистки и генерировать планы организации. Пользователи могут взаимодействовать со своими данными через терминал или подключая AI клиенты, такие как Claude или Codex, для выполнения сложных задач по чтению и планированию.
Для использования этого сервера необходимо предоставить токен Raindrop, хранящийся в приватном конфигурационном файле. Система спроектирована как независимая от провайдера, что означает, что вы можете подключать хостинговые модели или запускать локальные варианты, такие как Qwen и Laya. Особое внимание уделяется безопасности: вы можете просмотреть предлагаемые изменения, такие как новые теги или перемещение в коллекции, через процесс dry-run перед тем, как любые модификации будут фактически применены к вашему аккаунту. Это гарантирует, что ваши существующие теги и заметки останутся нетронутыми в процессе реорганизации.
Что вы можете с ним делать
- 1Проведение аудита для очистки библиотекиЗапускайте отчеты для выявления закладок, требующих внимания или реорганизации.
- 2Поиск и управление коллекциями через CLIИспользуйте shell-команды для поиска определенных типов ссылок или управления деревом ваших коллекций.
- 3Безопасный просмотр предлагаемых измененийПроверяйте, какие именно закладки и теги будут изменены, прежде чем приступать к выполнению плана организации.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить rdrop MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка rdrop MCP в Claude Code
$ claude mcp add --env 'RAINDROP_TOKEN=<YOUR_RAINDROP_TOKEN>' raindrop-cli -- npx -y @machineyearn/raindrop-cliУстановка rdrop MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"raindrop-cli": {
"command": "npx",
"args": [
"-y",
"@machineyearn/raindrop-cli"
],
"env": {
"RAINDROP_TOKEN": "<YOUR_RAINDROP_TOKEN>"
}
}
}
}Установка rdrop MCP в VS Code
.vscode/mcp.json
{
"servers": {
"raindrop-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@machineyearn/raindrop-cli"
],
"env": {
"RAINDROP_TOKEN": "<YOUR_RAINDROP_TOKEN>"
}
}
}
}Установка rdrop MCP в VS Code CLI
$ code --add-mcp '{"name":"raindrop-cli","type":"stdio","command":"npx","args":["-y","@machineyearn/raindrop-cli"],"env":{"RAINDROP_TOKEN":"<YOUR_RAINDROP_TOKEN>"}}'Установка rdrop MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"raindrop-cli": {
"command": "npx",
"args": [
"-y",
"@machineyearn/raindrop-cli"
],
"env": {
"RAINDROP_TOKEN": "<YOUR_RAINDROP_TOKEN>"
}
}
}
}Установка rdrop MCP в Codex
$ codex mcp add raindrop-cli --env 'RAINDROP_TOKEN=<YOUR_RAINDROP_TOKEN>' -- npx -y @machineyearn/raindrop-cliУстановка rdrop MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.raindrop-cli] command = "npx" args = ["-y", "@machineyearn/raindrop-cli"] [mcp_servers.raindrop-cli.env] RAINDROP_TOKEN = "<YOUR_RAINDROP_TOKEN>"
Установка rdrop MCP в Gemini CLI
$ gemini mcp add -s user -e 'RAINDROP_TOKEN=<YOUR_RAINDROP_TOKEN>' raindrop-cli npx -- -y @machineyearn/raindrop-cliУстановка rdrop MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"raindrop-cli": {
"command": "npx",
"args": [
"-y",
"@machineyearn/raindrop-cli"
],
"env": {
"RAINDROP_TOKEN": "<YOUR_RAINDROP_TOKEN>"
}
}
}
}Конфигурация
RAINDROP_TOKENСекретRaindrop.io API token. Alternatively configure the private rdrop env/token file; see setup.
| Название | Описание | Тип |
|---|---|---|
| RAINDROP_TOKEN | Raindrop.io API token. Alternatively configure the private rdrop env/token file; see setup. | Секрет |
Автоматические проверки
Запущено 13 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийkingpsychopath/raindrop-cli is public and reachablegithub.com/kingpsychopath/raindrop-cli ↗Пройдено
- Пакет указывает этот репозиторий как источник@machineyearn/raindrop-cli names kingpsychopath/raindrop-cli as sourcenpmjs.com/package/@machineyearn/raindrop-cli ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-03github.com/kingpsychopath/raindrop-cli ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @machineyearn/raindrop-cliПройдено
- Нет критических предупреждений в пакете или его зависимостях7 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubrdrop for Raindrop.io
Find, review and organize your saved links. Keep your tags. Bring your own AI.
Turn a growing Raindrop.io library into something easier to use. Search saved links, inspect collections, find cleanup opportunities and review suggestions before making changes. Use it from your terminal or let your favorite agent do the reading and planning.
A Raindrop.io CLI, MCP server and reviewed bookmark organizer from Machineyearn, built as an independent integration.
- Your organization stays yours. Start with the tags and collections you already created; preserve existing tags when applying a plan.
- Changes you can inspect. See exact bookmarks, proposed tags and destinations, then dry-run the plan before applying it.
- AI that fits your workflow. Connect Codex or Claude, use a hosted tool-capable model, or run local Qwen and Laya.
- A useful CLI without AI. Search, edit, export, manage highlights and collections, and build shell pipelines.
Get started
1. Install
brew install machineyearningengineer/tap/rdrop
# Or Node 22+, with optional dependencies enabled:
npm install --global @machineyearn/raindrop-cli@0.2.1
rdrop version
Prefer no global install? Use npx --yes @machineyearn/raindrop-cli@0.2.1 COMMAND. Native downloads cover macOS, Linux and Windows on Intel/AMD and ARM. Builds and checksums.
2. Connect Raindrop
Create a token in your Raindrop integration settings. Add it to the private file ~/.config/rdrop/env:
RAINDROP_TOKEN=your_token_here
Give the directory permissions 700 and the file 600, then run rdrop doctor. Keep the token out of chat and Git. Setup and troubleshooting.
3. Ask your agent
Copy this into Codex, Claude or your preferred coding agent. It can help with setup too:
Set up https://github.com/machineyearningengineer/raindrop-cli so you can help
manage my Raindrop library. Use its plugin/MCP when available, otherwise
use the CLI. Check installation and authentication; have me add the token
privately. Use the existing model and configured services first.
Start with a cleanup report and a small sample. Use my existing tags and
collections. Choose useful tools for search, content, classification and
planning; connect extra model providers, Executor or ACP only if needed.
Show the exact proposed changes and a dry-run. Preserve my tags and notes,
flag uncertain suggestions, and apply only the exact plan I approve.
Connect an agent, or start in your shell with rdrop collections --tree, rdrop search 'type:article #go' --json and rdrop cleanup report --json.
Choose your workflow
| You want to… | Start here |
|---|---|
| Find links, manage collections or export your library | Shell commands |
| Use Codex, Claude or another MCP client | Client setup and plugins |
| Ask a model to inspect your library and propose changes | Run a model directly |
| Use Raindrop's semantic search and AI-assisted reads | Official MCP tools |
| Classify selected bookmarks with Jev, Laya or Clef | Decision providers |
| Run portable Raindrop tools in Executor | Executor setup |
Organize with a plan
Begin with a report and select the exact bookmarks you want to review:
rdrop cleanup report --json > cleanup-report.json
rdrop context --ids 101,102 > library-context.json
jq 'del(.snapshots)' library-context.json > model-context.json
The model view contains your existing tag names, collection paths and bookmark metadata. Keep the original context private: its snapshots are used to detect edits before applying. Ask any model or rule engine for the proposal format, then validate it:
rdrop organize plan --context library-context.json --proposal proposal.json > organization.json
jq '.plan // error("No accepted changes")' organization.json > reviewed-plan.json
# Review accepted changes, needsReview and unmentioned items.
rdrop cleanup apply reviewed-plan.json --dry-run
rdrop cleanup apply reviewed-plan.json --yes
Plans keep existing tags and can combine new tags with a collection move. Unknown names and destinations fail validation; new tags need explicit naming rules. Account, digest and snapshots are checked before writing. Concurrent edits or partial failures need inspection and a fresh plan. Organizing and recovery.
Use your agent
The Codex and Claude plugin bundles a shared organizing skill and a read-only MCP connection. Install instructions also cover direct setup for other local clients.
rdrop connect mcp # client configuration, without tokens
rdrop mcp serve # read-only tools over stdio
rdrop mcp tools --search 'organize tags' # discover relevant schemas offline
rdrop mcp tools --name raindrop_context # inspect one exact schema
rdrop mcp serve --official # also include Raindrop's hosted AI reads
Default tools read and plan. Enable writes only for an authorized host that enforces review. The official extension imports documented read tools; its plan limits and service availability still apply. Coverage and comparison with the official server.
You can also run a model directly:
# With your model API key in a private environment:
rdrop agent --model your-tool-capable-model --json \
'Review the first page of untagged bookmarks. Use existing tags and propose a plan.' > agent-result.json
The model receives actual tool results and returns a response plus exact generated plans. Step, call and time limits bound the run. Local Chat Completions servers and hosted Responses APIs are supported. Jev, Laya and Cloudflare Clef provide typed category decisions; uncertainty stays visible. Model setup and exact commands.
Verified and maintained
A real Qwen/Laya loop classified bookmarks, generated a plan and applied it to a disposable test library while preserving existing tags and notes. The local Executor deployment passed connected-account health and live read checks. Repeat the verification, including its limits: this smoke check is not an accuracy benchmark, and Jev/Clef live inference requires provider credentials.
The product focuses on Raindrop. Model providers and proposal formats are agnostic; Obsidian and other note sources remain future options.
For developers
The public name is rdrop for Raindrop.io. Stable technical identifiers are the raindrop-cli repository, @machineyearn/raindrop-cli npm package, rdrop command and raindrop@machineyearn plugin. Storage support currently focuses on Raindrop.io; model and agent connections are provider-neutral.
A native Go CLI, local MCP server and direct model loop share the command implementation. The REST client, model clients and planning code use the standard library; MCP uses the official Go SDK. ACP configuration supplies this server to an existing ACP agent. Executor offers a smaller portable REST adapter. Docker is available as a packaging option.
make check # Go checks, build and generated-doc parity
make check-integrations # npm, Executor and Laya contracts
make assets # regenerate the terminal graphic
Вопросы о rdrop MCP
Как добавить rdrop MCP в Claude Code?
Выполните claude mcp add --env 'RAINDROP_TOKEN=<YOUR_RAINDROP_TOKEN>' raindrop-cli -- npx -y @machineyearn/raindrop-cli в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить rdrop MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Сохраняются ли мои существующие теги?
Да, инструмент спроектирован так, чтобы использовать ваши текущие теги и коллекции и сохранять их при применении плана организации.
Как я могу предварительно просмотреть изменения перед их применением?
Вы можете использовать флаг dry-run при применении плана очистки, чтобы увидеть предлагаемые изменения без их фактического выполнения.