roo-mcp

Servidor MCP para Roo, la API de enlaces cortos inteligentes. Expone las operaciones de enlaces y complementos de Roo como herramientas MCP ligeras y bien definidas que un LLM puede usar directamente.

¿Eres nuevo aquí? Consulta SETUP.md para obtener una guía de instalación paso a paso (Claude Desktop, Claude Code, Cursor).

Instalación

Opción A — plugin de Claude Code (un comando; incluye MCP + skill juntos)

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

Luego, establece tu clave de API una vez como variable de entorno de usuario para que el servidor generado la herede:

# 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

Reinicia tu terminal y Claude Code. Obtendrás ambos:

• Las 14 herramientas roo_* (a través del servidor MCP declarado en .mcp.json).

• El skill roo-shortlinks (en skills/roo-shortlinks/) que enseña a Claude cuándo recurrir a qué complemento.

Opción B — Configuración manual de MCP (Claude Desktop, Cursor, Continue.dev, otros clientes MCP)

Añade lo siguiente al archivo de configuración de tu cliente MCP:

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

Consulta SETUP.md para conocer la ruta exacta del archivo de configuración según el cliente. Obtén una API key en https://roo.bz — consulta los ajustes de API de tu cuenta.

Related MCP server: shrtnr MCP Server

Desarrollo local

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

Resolución de la clave: al iniciar, el servidor busca ROO_API_KEY en este orden:

1. process.env.ROO_API_KEY — la forma en que los clientes MCP la inyectan normalmente a través de su configuración mcpServers.env.

2. .env en la raíz del paquete (../ desde el script compilado) — una conveniencia para el desarrollo local, especialmente cuando un cliente MCP de escritorio (Claude Desktop, etc.) no transmite de forma fiable las variables de entorno del usuario a los procesos generados.

Si no hay ninguna, el servidor termina con un mensaje de error claro.

Herramientas (implementadas / planificadas)

• roo_whoami — verifica la clave y resumen compacto de la cuenta.

• roo_list_shortlinks, roo_create_shortlink, roo_get_shortlink, roo_update_shortlink — CRUD.

• roo_make_permanent, roo_update_permanent_settings — permanencia.

• roo_get_qr_code — obtiene el código QR (data URI en base64 o escribir en un archivo).

• roo_set_scheduled_redirect, roo_set_click_count_redirect, roo_set_webhook, roo_set_preview_link, roo_set_qr_addon — los cinco complementos.

Diseño y especificación

• DESIGN.md — documento de diseño (catálogo de herramientas, arquitectura, manejo de errores).

• skills/roo-shortlinks/SKILL.md — skill complementario de Claude (capa de juicio), incluido con el plugin.

• SPEC-NOTES.md — hallazgos de la especificación frente a la realidad, obtenidos en pruebas en vivo.

• roo-openapi.json — la especificación Swagger 2.0 extraída.