roo-mcp

MCP-Server für Roo — die Smart-Shortlink-API. Stellt die Link- und Add-on-Operationen von Roo als schlanke, wohldefinierte MCP-Tools bereit, die ein LLM direkt verwenden kann.

Neu hier? Eine Schritt-für-Schritt-Installationsanleitung (Claude Desktop, Claude Code, Cursor) findest du in SETUP.md.

Installation

Option A – Claude Code-Plugin (ein Befehl; liefert MCP + Skill zusammen aus)

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

Setze anschließend deinen API-Schlüssel einmal als Benutzer-Umgebungsvariable, damit der gestartete Server ihn erbt:

# 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

Starte dein Terminal und Claude Code neu. Du erhältst dann beides:

• Die 14 roo_*-Tools (über den in .mcp.json deklarierten MCP-Server).

• Das roo-shortlinks-Skill (unter skills/roo-shortlinks/), das Claude vermittelt, wann es zu welchem Add-on greifen soll.

Anleitung, manuelle MCP-Konfiguration (Claude Desktop, Cursor, Continue.dev, andere MCP-Clients)

Füge Folgendes zu deiner MCP-Client-Konfigurationsdatei hinzu:

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

Den genauen Pfad der Konfigurationsdatei pro Client findest du in SETUP.md. Einen API-Schlüssel erhältst du unter https://roo.bz – siehe die API-Einstellungen deines Kontos.

Related MCP server: shrtnr MCP Server

Lokale Entwicklung

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

Schlüsselermittlung: Beim Start sucht der Server in dieser Reihenfolge nach ROO_API_KEY:

1. process.env.ROO_API_KEY – so injizieren ihn MCP-Clients normalerweise über ihre mcpServers.env-Konfiguration.

2. .env im Stammverzeichnis des Pakets (../ relativ zum Build-Skript) – praktisch für die lokale Entwicklung, vor allem wenn ein Desktop-MCP-Client (Claude Desktop usw.) Benutzer-Umgebungsvariablen nicht zuverlässig an gestartete Prozesse weitergibt.

Ist beides nicht vorhanden, beendet sich der Server mit einer klaren Fehlermeldung.

Tools (implementiert / geplant)

• roo_whoami – verifiziert den Schlüssel und liefert eine kompakte Kontozusammenfassung.

• Zum CRUD gehören roo_list_shortlinks, roo_create_shortlink, roo_get_shortlink, roo_update_shortlink.

• roo_make_permanent, roo_update_permanent_settings – Dauerhaftigkeit.

• roo_get_qr_code – QR-Code abrufen (als Base64-Daten-URI oder in Datei schreiben).

• roo_set_scheduled_redirect, roo_set_click_count_redirect, roo_set_webhook, roo_set_preview_link und roo_set_qr_addon – die fünf Add-ons.

Design & Spezifikation

• DESIGN.md – Bauplan bzw. Kurzbeschreibung des Builds (Tool-Katalog, Architektur, Fehlerbehandlung).

• skills/roo-shortlinks/SKILL.md – zugehöriges Claude-Skill (Entscheidungsebene), gebündelt mit dem Plugin.

• SPEC-NOTES.md – Befunde zu Spezifikation vs. Realität aus Live-Tests.

• roo-openapi.json – die extrahierte Swagger-2.0-Spezifikation.