mcpField
R
RoadRaven

RoadRaven

ローカル
shuffzord.github.io生産性92 日前に更新
リポジトリ公式サイト

RoadRaven について

RoadRavenのMCPサーバーは、Claude CodeなどのMCPホストを起動中のRoadRavenデスクトップアプリに接続し、エージェントによるロードマップ管理を可能にします。21個のツールと、Claude Code向けの2つのワークフロースキルを備えています。

主な機能

  1. 01開いているロードマップの読み取り
  2. 02ノードの作成、編集、移動、削除
  3. 03ロードマップのノード状態の設定
  4. 04Claude Code向けワークフロースキル2種

活用シーン

  1. 01依頼を段階的なロードマップに整理
  2. 02ロードマップのタスクを実行して状態を更新

MCP 対応

ローカルのstdio MCPサーバーが、起動中のRoadRavenアプリ内のロードマップを読み書きする21個のツールを公開します。127.0.0.1上のWebSocketで接続します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "shuffzord-roadraven": {
      "command": "npx",
      "args": [
        "-y",
        "@roadraven/mcp"
      ]
    }
  }
}
起動コマンドnpx -y @roadraven/mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@roadraven/mcp0.9.2

ツール

21

掲載時のツール一覧 · 2 日前に更新

パラメーター型必須説明
metaobjectいいえ任意のキーと値のメタデータ。例：{ branch, commit, ci_run_id }
nodeIdstringはいロードマップ内のノード UUID
statusenumはいコアノードのステータスnot-started | in-progress | completed | blocked
expectedRevisionintegerいいえ最後に getRoadmap/getNode を読み取ったときのリビジョンです。その後ロードマップが変更されている場合、上書きせず stale_write エラーで書き込みが失敗します。

詳細

@roadraven/mcp — Claude Code 向け RoadRaven

RoadRaven の MCP サーバーと Claude Code プラグインです。RoadRaven は、プロジェクトの計画をツリー形式で表示し、作業の進行に合わせてリアルタイムに更新するローカルデスクトップアプリです。このサーバーは、開いているロードマップの読み取り、ノードの作成、編集、移動、削除、ステータスの設定を行う21個のツールをエージェントに提供します。プラグインには、これらのツールを使って計画を立て、実際の作業を進める方法をClaudeに教える2つのスキルが含まれています。

ソース公開、FSL-1.1-MIT。

アプリを起動しておく必要があります

すべてのツールは、127.0.0.1 上のローカル接続を介してRoadRavenデスクトップアプリと通信します。アプリが閉じている場合、ツールは app_not_running を返します。ロードマップが開かれていない場合は、no_file_loaded を返します。アプリが開いたり保存したりできるのは、すでに作業している場所のファイルのみです。そのため、別のパスを指定したリクエストには path_not_permitted を返します。まずアプリをインストールしてください。インストールを参照してください。

お使いのマシンでの動作

  • npmから npx 経由で @roadraven/mcp をダウンロードして実行します。バージョンはプラグインと完全に一致するものに固定され、ローカルのstdio MCPサーバーとして動作します。
  • 読み取るファイルは1つだけです。デスクトップアプリがローカルポートを書き込む、RoadRavenのユーザーデータフォルダーにある event-api.json です（Linuxでは ~/.config/RoadRaven、Windowsでは %LOCALAPPDATA%\RoadRaven）。
  • 127.0.0.1 上のWebSocketを介してRoadRavenデスクトップアプリにのみ接続し、開いているロードマップを読み取って編集します。それ以外の場所には何も送信せず、テレメトリも収集しません。
  • ファイルを書き込むのは、ご自身で npx @roadraven/mcp init を実行した場合のみです。CLAUDE.md に短いRoadRavenセクションを追加するかどうかを確認し、先に許可を求めます。
  • スキルはClaude向けの指示です。スキル単独では何も実行しません。

インストール

簡単なものから順に、3つの方法があります。

セットアップウィザード。 RoadRavenを起動します。初回起動時のセットアップウィザードがClaude CodeとOpenCodeを検出し、ワンクリックでこのサーバーを登録します。上部の⚙ボタンから再度開けます。以下のClaude Codeプラグインがすでにインストールされている場合、ウィザードはそちらを優先します。

Claude Codeプラグイン。 Node.js >= 24が必要です。Claude Code内から実行します。

/plugin marketplace add Shuffzord/RoadRaven
/plugin install roadraven@roadraven

その他のMCPホスト。 Node.js >= 24が必要です。インストール済みのアプリに対応するバージョンを指定してください（メジャー・マイナーバージョンが一致しない場合、アプリが警告します）。

claude mcp add -s user roadraven -- npx -y @roadraven/[email protected]

CLAUDE.md に短いRoadRavenセクションを追加するには（現在のプロジェクトと ~/.claude/CLAUDE.md のどちらを使うか確認されます）、npx -y @roadraven/[email protected] init を実行します。

スキル

スキルはClaude Codeプラグインのインストールにのみ含まれます。セットアップウィザードと npx を使う方法では、スキルなしでツールを利用できます。

roadraven:orchestrate は、リクエストをロードマップツリー（目標、フェーズ、タスク）に変換し、フェーズごとの概要を作成して、各フェーズをサブエージェントに割り当てます。プロジェクト独自のチェックを再実行して結果を検証し、作業を見守る間、ノードのステータスを最新に保ちます。

Plan the CSV export feature as a roadmap in RoadRaven and run it phase by phase.

roadraven:work-node は、1つのタスクを完了するためのスキルです。ノードを取得して進行中に設定し、メモにチェックポイントを記録します。概要で指定されたファイルだけを編集し、まず失敗するテストを実行して修正を検証してから、チェックを実行し、結果を報告して、最終ステータスを設定します。

Pick up the first not-started node in the open roadmap, do the work, and keep its status current.

どちらのスキルも、プロジェクトのREADME、パッケージマニフェスト、またはCI設定からテスト、Lint、ビルドのコマンドを見つけるため、どの言語でも利用できます。アプリが起動していない場合は、一度だけ起動するよう求めた後、Markdownの作業ログに切り替えて、その旨を伝えます。

詳しくは、MCPインストールガイド、プラグイン作成ガイドをご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。