SkillFoxx
Telegram

Roam Research MCP

MCP-сервер и CLI читают и пишут граф Roam Research через серверный API без запущенного приложения, с защитой записи ключом.

  • 100 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Токен графа дает чтение и запись всего графа, а пакетные действия умеют удалять блоки.
  • HTTP-демон без токена доступа открывает граф всей сети.
Все причины и проверки

2b3pro/roam-research-mcpАвтор:2b3pro

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/roam-research-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Токен графа дает чтение и запись всего графа, а пакетные действия умеют удалять блоки.
  • HTTP-демон без токена доступа открывает граф всей сети.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Roam Research MCP, MCP-сервер и консольная программа `roam`, дает агенту доступ к графу заметок Roam Research. Инструменты ищут страницы и блоки, читают страницы с обратными ссылками, создают страницы, таблицы и списки, переносят блоки, ведут задачи и выполняют запросы Datalog. Страница обновляется умным сравнением и сохраняет идентификаторы блоков, поэтому ссылки на них не рвутся. Сервер обращается к серверному API Roam по токену графа, настольное приложение не нужно. Он работает по stdio или как общий HTTP-демон `roam server`. К одному серверу подключают несколько графов, а запись в выбранные закрывают ключом `write_key`. Инструмента удаления страниц здесь нет сознательно.

Для кого. Пользователям Roam Research, которые ведут заметки в графе и хотят, чтобы Claude Code или другой MCP-клиент искал, дополнял и приводил их в порядок.

Подходит, если

  • Агент ищет в графе все блоки с тегом или TODO и собирает сводку.
  • Мысли и задачи уходят на страницу дня командой `roam save`, в том числе из конвейера.
  • Граф нужен серверу, контейнеру или CI, где настольный Roam не запущен.
  • К одному серверу подключены несколько графов, а запись в рабочий закрыта ключом.

Не подходит, если

  • Интерфейс Roam Desktop и поиск по эмбеддингам удобнее вести через официальный сервер Roam: эти возможности есть у него.
  • Токен графа нельзя передавать стороннему пакету: он лежит в переменных окружения сервера.
  • Страницы собираются удалять через сервер: такого инструмента здесь нет.

Пример запроса к агенту

Найди в графе все блоки с тегом проекта, покажи их по страницам и добавь TODO на сегодняшнюю страницу.

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

ROAM_API_TOKEN обязательная, секрет
Токен API графа Roam
ROAM_GRAPH_NAME обязательная
Имя графа Roam
HTTP_AUTH_TOKEN секрет
Токен доступа для общего HTTP-демона вне loopback
HTTP_STREAM_PORT
Порт общего HTTP-демона

Ограничения

Нужны токен API Roam и имя графа, их хранят в переменных окружения сервера. Общий HTTP-демон на `0.0.0.0` без `HTTP_AUTH_TOKEN` открывает чтение всех графов любому в сети. Ключ `write_key` защищает только запись в закрытые графы. Команда `npx -y roam-research-mcp` подтягивает последнюю версию при каждом запуске, поэтому мажорную версию лучше закрепить. Блоки с тегами `#.rm-hide` и `#.rm-private` агенту не отдаются.

Как отключить. Удалите запись `roam-research` из настроек MCP-клиента и остановите демон командой `roam server stop`, если запускали его. Токен графа в окружении и файлы в `~/.roam/` удалите отдельно.

Частые вопросы

Чем он отличается от официального сервера Roam?

Официальный работает через локальный API настольного Roam и требует запущенного приложения. Этот использует серверный API, работает без интерфейса и добавляет CLI, общий HTTP-демон, пакетные операции и память агента.

Как подключить несколько графов?

Переменной `ROAM_GRAPHS` с токенами и именами графов. Для записи в защищенный граф нужен `write_key`.

Как скрыть блоки от ИИ?

Тегами `#.rm-hide` и `#.rm-private`: такие блоки сервер не отдает. Метки общие с официальным сервером.

Как запустить общий демон?

Командой `roam server start`, порт задает `HTTP_STREAM_PORT`. За пределами loopback обязательно задайте `HTTP_AUTH_TOKEN`.

Как сохранить мысль из терминала?

Командой `roam save "идея"` или через конвейер: `echo "Купить молоко" | roam save --todo`.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Roam Research MCP и CLI

Roam Research MCP and CLI

Официальный

Агент ищет, читает и пишет в граф Roam Research через локальный API настольного приложения, есть CLI и скилл с синтаксисом

MCP-серверШирокий доступ62
Официальный

Официальный облачный MCP-сервер Atlassian для Jira, Confluence, Jira Service Management, Bitbucket, Compass и Loom со скиллами

MCP-серверШирокий доступ1,2 тыс.

MCP-эндпоинт рабочего пространства Salt на вашем сервере: агент создает страницы и базы, ищет и комментирует с правами человека.

MCP-серверШирокий доступ178

MCP-сервер для Logseq: агент читает, ищет и правит страницы и блоки графа через локальный HTTP API

MCP-серверШирокий доступ351
Официальный

MCP-сервер только для чтения: Claude Code, Claude Desktop и Codex ищут по локальным встречам, заметкам и транскриптам DoodleNote

MCP-серверРасширенный доступ186
Официальный

Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом

MCP-серверРасширенный доступ16

Коротко о README

README начинается с истории: автор хотел управлять графом из Claude Code, а инструменты выросли в самостоятельный CLI. Отдельно описаны версии 6.0 и 6.1: единая постраничная выдача поиска и ответ `BLOCK_NOT_FOUND` вместо ложного успеха при удалении.

Бейдж для README

Сообщить о проблеме