roo-mcp

Roo를 위한 MCP 서버 — 스마트 단축링크 API입니다. Roo의 링크 및 애드온 작업을 LLM이 직접 사용할 수 있는 간결하고 잘 정리된 MCP 도구로 노출합니다.

처음이신가요? 단계별 설치 가이드는 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.json에 선언된 MCP 서버를 통함).

• 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_shortlink, roo_get_shortlink, roo_update_shortlink — CRUD.

• roo_make_permanent, roo_update_permanent_settings — 영구화(Permanent) 설정.

• 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 — 다섯 가지 애드온.

설계 및 스펙