roo-mcp

MCP-сервер для Roo — API умных коротких ссылок. Предоставляет операции Roo со ссылками и дополнениями в виде компактных, хорошо структурированных MCP-инструментов, которые LLM может использовать напрямую.

Впервые здесь? Пошаговая инструкция по установке — в SETUP.md (Claude Desktop, Claude Code, Cursor).

Установка

Вариант A — плагин для Claude Code (одна команда; MCP и навык поставляются вместе)

claude plugin add https://github.com/roo-bz/roo-mcp.git

Затем один раз задайте ваш API-ключ как переменную окружения пользователя, чтобы запускаемый сервер унаследовал её:

# Windows PowerShell
[Environment]::SetEnvironmentVariable('ROO_API_KEY', 'your-roo-api-key', 'User')

# macOS / Linux — in ~/.zshrc or ~/.bashrc
export ROO_API_KEY=your-roo-api-key

Перезапустите терминал и Claude Code. Вы получите оба компонента:

• 14 инструментов roo_* (через MCP-сервер, объявленный в .mcp.json).

• Навык roo-shortlinks (в папке skills/roo-shortlinks/), который подсказывает Claude, когда и какое дополнение использовать.

Вариант B — ручная настройка MCP (Claude Desktop, Cursor, Continue.dev, другие MCP-клиенты)

Добавьте в файл конфигурации вашего MCP-клиента:

{
  "mcpServers": {
    "roo": {
      "command": "npx",
      "args": ["-y", "@roo-bz/roo-mcp"],
      "env": { "ROO_API_KEY": "your-roo-api-key" }
    }
  }
}

Точный путь к файлу конфигурации для каждого клиента — в SETUP.md. Получите API-ключ на https://roo.bz — в настройках API вашего аккаунта.

Related MCP server: shrtnr MCP Server

Локальная разработка

npm install
cp .env.example .env    # then paste ROO_API_KEY into .env
npm run build
node scripts/smoke.mjs  # spawns the built server, calls tools/list + roo_whoami

Поиск ключа: при запуске сервер ищет ROO_API_KEY в следующем порядке:

1. process.env.ROO_API_KEY — так MCP-клиенты обычно передают его через конфигурацию mcpServers.env.

2. .env в корне пакета (../ относительно собранного скрипта) — удобно для локальной разработки, особенно когда десктопный MCP-клиент (Claude Desktop и т. п.) не передаёт надёжно пользовательские переменные окружения порождаемым процессам.

Если нет ни того, ни другого, сервер завершает работу с понятной ошибкой.

Инструменты (реализованные / запланированные)

• roo_whoami — проверка ключа и краткая сводка по аккаунту.

• roo_list_shortlinks, roo_create_shortlinks, roo_get_link, roo_update_shortlink — CRUD.

• roo_make_permanent, roo_update_permanent_settings — постоянные ссылки.

• roo_get_qr_code — получить QR-код (base64 data URI или записать в файл).

• roo_set_scheduled_redirect, roo_set_click_count_redirect, roo_set_webhook, roo_set_preview_link, roo_set_qr_addon — пять дополнений.

Дизайн и спецификация

• DESIGN.md — техническое задание на разработку (каталог инструментов, архитектура, обработка ошибок).

• skills/roo-shortlinks/SKILL.md — сопутствующий навык для Claude (слой принятия решений), поставляется вместе с плагином.

• SPEC-NOTES.md — расхождения между спецификацией и реальностью по результатам живых проб.

• roo-openapi.json — извлечённая спецификация Swagger 2.0.