Roam Research MCP и CLI
Roam Research MCP and CLI
Агент ищет, читает и пишет в граф Roam Research через локальный API настольного приложения, есть CLI и скилл с синтаксисом
- 62 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- При уровне `full` агент создает, правит и удаляет страницы и блоки, а массовые изменения в Roam не откатить
- Скрытые тегами `#.rm-hide` и `#.rm-private` блоки остаются доступны через `datalog_query`
- Токен действует на целый граф, и сервер уровень доступа не проверяет, это делает сам Roam
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/roam-research-mcp-and-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- При уровне `full` агент создает, правит и удаляет страницы и блоки, а массовые изменения в Roam не откатить
- Скрытые тегами `#.rm-hide` и `#.rm-private` блоки остаются доступны через `datalog_query`
- Токен действует на целый граф, и сервер уровень доступа не проверяет, это делает сам Roam
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Официальный MCP-сервер и консольный клиент Roam Research подключают агента к графу знаний. Агент ищет страницы и блоки, читает страницы в виде Markdown, смотрит обратные ссылки, создает и правит блоки, дописывает заметки в ежедневную страницу и составляет запросы Datalog. Сервер обращается к локальному HTTP API настольного приложения Roam и при необходимости запускает его сам по ссылке. Веб-версия не подходит. Доступ задает токен: `npx @roam-research/roam-mcp connect` проводит по выбору графа и уровня прав (`full`, `read-append` или `read-only`), а сам токен человек подтверждает в окне Roam. В репозитории лежит скилл `roam-syntax`. Он объясняет агенту разметку Roam (курсив пишется как `__text__`) и устройство вывода читающих инструментов, чтобы запись не портила ссылки на блоки. Блоки с тегами `#.rm-hide` и `#.rm-private` читающие инструменты пропускают.
Для кого. Пользователям Roam Research с настольным приложением, которые ведут в графе заметки и хотят поручать агенту поиск, разбор и пополнение.
Подходит, если
- Итог рабочей сессии добавляется в ежедневную страницу одним запросом к агенту
- По теме собирается подборка: агент ищет страницы, читает обратные ссылки и подбирает ссылки на существующие страницы
- Сложная выборка по графу решается запросом Datalog, который агент составляет сам
- Рабочий граф подключается только на чтение, а публичный граф `help` читается как справочник
Не подходит, если
- Используется веб-версия Roam: локальный API есть только в настольном приложении
- Граф без резервной копии: удаленные агентом страницы и блоки вернуть бывает невозможно
- Права надо ограничить на стороне сервера: поле `accessLevel` в файле конфигурации лишь записывает выданный уровень, а права определяет токен Roam
Пример запроса к агенту
Дополни сегодняшнюю ежедневную заметку итогами рабочей сессии и найди страницы Roam, на которые стоит сослаться в тексте.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Ограничения
Проект в стадии alpha, возможны несовместимые изменения. Нужны Node.js 18 или новее и настольное приложение Roam.
При уровне `full` агент может создавать, править и удалять страницы и блоки, а у Roam нет истории отмены для массовых операций. Фильтр `#.rm-hide` и `#.rm-private` действует не везде: `datalog_query` читает базу напрямую и скрытые блоки покажет, а предпросмотр шаблонов в `search_templates` их не прячет.
Как отключить. Удалите сервер из Claude Code командой `claude mcp remove roam-mcp`. Подключение к графу снимает `npx @roam-research/roam-mcp connect --remove --graph <имя>`, а токены лежат в настройках графа Roam, раздел Local API Tokens.
Частые вопросы
Как подключить Roam к Claude Code?
Сначала выполните `npx @roam-research/roam-mcp connect`: команда проведет по выбору графа и прав, а токен нужно подтвердить в приложении Roam. Затем `claude mcp add -s user roam-mcp -- npx -y @roam-research/roam-mcp`. Для одного проекта вместо `-s user` укажите `-s local`.
Работает ли сервер с веб-версией Roam?
Нет. Локальный API есть только в настольном приложении, и оно должно быть установлено. Если Roam закрыт, сервер откроет его по ссылке и повторит подключение.
Можно ли дать агенту только чтение?
Да. При `connect` выберите уровень `read-only`, есть еще `read-append` и `full`. Публичный граф подключается флагом `--public` и читается только на чтение.
Как работать с несколькими графами?
Запустите `connect` для каждого графа и задайте короткие имена. Единственный граф выбирается сам, а при нескольких агент передает имя в параметре `graph`.
Как задать агенту правила работы с графом?
Создайте страницу `[[roam/agent guidelines]]` с инструкциями: инструмент `get_graph_guidelines` вернет их агенту. Туда можно записать соглашения об именах, структуру страниц и темы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальная база заметок в Markdown с MCP-сервером и скиллами: Claude Code, Cursor, Codex и Gemini CLI читают один и тот же контекст
mcp-logseq — MCP-сервер для Logseq
MCP server for LogSeq
MCP-сервер для Logseq: агент читает, ищет и правит страницы и блоки графа через локальный HTTP API
DoodleNote MCP — заметки встреч для агентов
DoodleNote MCP
MCP-сервер только для чтения: Claude Code, Claude Desktop и Codex ищут по локальным встречам, заметкам и транскриптам DoodleNote
MCP-сервер на Rust для папки с заметками в Markdown: агент ищет, читает заметки, видит обратные ссылки, теги, задачи и историю версий
Заметки на Cloudflare Workers без своего сервера с MCP-конечной точкой и скиллом, через которые агент ищет и пишет ваши записи
MCP-сервер и CLI, которые находят в сессиях Claude Code и Codex, почему файл стал таким: кто и о чем просил агента, когда и что изменилось
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Roam Research MCP и CLI (эта карточка) | да | API-ключ | 62 | |
| mcp-obsidian | нет | API-ключ | 4 522 | заметки в Obsidian, граф Roam не читает |
| mcp-logseq — MCP-сервер для Logseq | нет | API-ключ | 350 | граф в Logseq, а не в Roam |
| Notion MCP Server | да | API-ключ | 4 698 | рабочее пространство Notion, другая модель данных |
Коротко о README
Документация разбирает подключение графа в интерактивном и неинтерактивном режимах, ручную настройку файла `~/.roam-tools.json`, перечень инструментов по группам и работу с несколькими графами. Репозиторий устроен как монорепозиторий из четырех пакетов: ядро, локальный транспорт, MCP-сервер и CLI.