roo-mcp

Roo 用の MCP サーバー — スマートショートリンク API。Roo のリンク操作とアドオン操作を、LLM が直接利用できる薄く整った MCP ツールとして公開します。

はじめての方ですか？ ステップバイステップのインストールガイド (SETUP.md を参照してください) — Claude Desktop、Claude Code、Cursor には、以下の手順をご利用ください。

インストール

オプション A — Claude Code プラグイン（1コマンドで 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 など）が、ユーザー環境変数を spawn されたプロセスへ確実は渡さない場合に役立ちます。

本地址が存在しなければ、サーバーは明確なエラーを表示して終了します。

ツール（実装済み / 予定）

• roo_whoami — キーの検証と簡潔なアカウントの概要。

• roo_list_shortlinks, roo_create_shortlink, roo_get_shortlink, roo_update_shortlink — CRUD。

• roo_make_permanent, roo_update_permanent_settings — 永続化。

• roo_get_qr_code — QR コードの取得（base64 データ URI として、またはファイルに書き出し）。

• roo_set_scheduled_redirect, roo_set_click_count_redirect, roo_set_webhook, roo_set_preview_link, roo_set_qr_addon — 5つのアドオン。

設計と仕様

• DESIGN.md — ビルド概要（ツールカタログ、アーキテクチャ、エラーハンドリング）。

• skills/roo-shortlinks/SKILL.md — 付随する Claude スキル（判断レイヤー）。プラグインにバンドルされています。

• SPEC-NOTES.md — 実地プローブによる仕様差分の検証結果。

• roo-openapi.json — 抽出された Swagger 2.0 仕様。