Roamer MCP

roamer-mcp-plugin

Roamer MCP 用の配布可能な Claude Code プラグインです。Roamer MCP は、Roamer プロジェクトレジストリ、行動仕様データベース、エンジニアリングスレッドを提供する MCP サーバーです。詳しくは roamermcp.mathismeadows.com をご覧ください。

このプラグインは、ホスト型 Roamer MCP サーバー（https://roamer-mcp.mathismeadows.com/mcp）に追加できるオプションです。そのサーバーに接続するだけで、すべてのツールとワークフローをすでに利用できます。このプラグインをインストールすると、スラッシュコマンドとして使える11個のワークフローが追加されます。それぞれスラッシュコマンドとして使えますが、会話の内容に応じて Claude が自動的に呼び出すこともできるため、コマンドを自分で入力する必要はありません。

• /roamer:orient — セッション開始時のブリーフィング（プロジェクトレジストリ＋未解決のスレッド）
• /roamer:breadcrumb — セッション終了時のチェックポイント（レジストリ＋スレッドの更新）
• /roamer:feature — 7段階のゲート付き機能開発ワークフロー
• /roamer:bug — 8段階のゲート付きバグ修正ワークフロー
• /roamer:spec-audit — 仕様カバレッジの監査
• /roamer:spec-check — 衛生状態のチェックリスト
• /roamer:thread-scrub — 未解決スレッドのバックログを必要に応じてガイド付きでレビューし、対応方針を決定
• /roamer:release-notes — 日付範囲を指定して Internal／External リリースノートの草案を作成（レビューのみ）
• /roamer:export — 仕様、スレッド、ブレインのスナップショットを、選択した形式でローカルファイルに保存
• /roamer:login — サインイン、またはこのセッションで使用するアカウントを切り替え
• /roamer:logout — このセッションの Roamer 接続からサインアウト
• /roamer:status — この接続でサインインしているアカウントを確認

インストール

/plugin marketplace add mathismeadows/roamer-mcp-plugin
/plugin install roamer@roamer

このプラグインは HTTP 経由でホスト型サーバーに接続するため、Node.js やローカルへのインストールは不要です。初回利用時は /mcp でサインインします。プラグインの Roamer サーバーを選択し、ブラウザーでサインインしてください。後からアカウントを切り替えるには、/mcp → 再認証を選択するか、認証をクリアを選択してサインアウトします。

クライアントごとに Roamer 接続は1つにしてください。Roamer を claude.ai コネクターとして追加している場合や、claude mcp add で追加している場合、Claude Code は同じ URL のプラグインサーバーとコネクターを重複として扱い、プラグインを優先します。セッションでどの接続を使用しているか明確にするため、/mcp で他の Roamer サーバーを無効にしてください。

1.x からのアップグレード

バージョン 2.0 では、プラグインの接続方法が変更されています。1.x はサーバー名 roamer でローカルブリッジ（npx @mathismeadows/roamer-device-auth）を起動していました。2.0 はサーバー名 mcp でホスト型サーバーに直接接続するため、ツール名は mcp__plugin_roamer_mcp__<tool> になります。更新後は次の操作を行ってください。

• /mcp で再度サインインします（ブリッジにキャッシュされたサインイン情報は 2.0 では使用されません）。
• /mcp または VS Code の MCP Servers ビューに roamer という名前のサーバーがまだ表示されている場合は、削除して再読み込みします。残った roamer サーバーは、出力なしでエラーを表示することがあります。
• 古い roamer サーバーに対して許可したツールの承認は、新しい名前には引き継がれません。

データとプライバシー

このプラグインは、ホスト型 Roamer MCP サーバー https://roamer-mcp.mathismeadows.com/mcp にのみ接続します。ワークフローに指定した引数（たとえばプロジェクト名や日付範囲）と、Roamer を通じて読み書きするコンテンツ（プロジェクト、仕様、スレッド、ブロッカー、セッションノート）をサーバーに送信します。ブラウザーで OAuth を使ってサインインします。プラグインがパスワードを参照または保存することはありません。このプラグインはローカルコードを実行せず、Markdown のスキルとサーバーアドレスだけで構成されています。Roamer によるデータの取り扱いについては、プライバシーポリシーをご覧ください。

ステータス

このリポジトリは公開されているため、上記のコマンドを使って直接インストールできます。新しいアカウントは初回ログイン時に自動的に作成されますが、現在は Roamer MCP のツールを利用する前に手動承認が必要です（ベータ版のアクセス制限）。利用が可能になったら通知します。

構成

• .claude-plugin/plugin.json — プラグインのマニフェスト
• .claude-plugin/marketplace.json — 自己参照型のマーケットプレイスエントリー
• .mcp.json — サーバー名 mcp で HTTP 経由で公開されている Roamer MCP サーバー
• skills/ — 上記のワークフローコマンド。それぞれ、現在の指示をサーバーから読み込みます

このリポジトリは配布のみを目的としており、サーバーコードやテストは含まず、Roamer MCP の公開 MCP エンドポイントを利用する以外に、Roamer MCP の内部アーキテクチャとは関係ありません。