outflow-mcp

outflow-mcp

AI コーディングエージェント（Claude Code、Claude Desktop、その他の MCP 対応クライアント）に、Outflow のライブアーキテクチャグラフをコンテキストとして提供する MCP（Model Context Protocol）サーバーです。ワークスペースの実際に稼働中のグラフを使って、エージェントが「このファイルは何に依存しているか」「これを変更すると何が壊れるか」「直近の一連の編集で循環依存が発生したか」といった質問をできます。

Outflow の既存の /api/v1 REST API とワークスペースグラフのルートを利用する薄いクライアントであり、グラフのロジックは重複して実装していません。

このパッケージは Outflow のメインモノレポ内で開発されていますが、独立した公開ミラーから公開されています：https://github.com/laurells/outflow-mcp — MCP レジストリ／クローラーが参照するリポジトリであり、npm publish もここから実行されます。リリースのたびに、変更内容は事前にここへ同期されます。

セットアップ

1. 公開するワークスペースの API キーを作成します。Outflow で、ワークスペース設定 → API Keys → 作成の順に進みます。生のキー（ofk_...）は一度だけ表示されるため、コピーしてください。
2. ワークスペース ID を確認します — ワークスペースの URL（.../workspace/<id>/...）またはワークスペース設定に記載されています。
3. サーバーをビルドします：

   cd packages/mcp-server
   npm install
   npm run build
   

4. MCP クライアントの設定に追加します。 Claude Code の場合は、MCP の設定（claude mcp add または同等の設定ファイル）に追加します：

   {
     "mcpServers": {
       "outflow": {
         "command": "node",
         "args": ["/absolute/path/to/outflow/packages/mcp-server/dist/index.js"],
         "env": {
           "OUTFLOW_BASE_URL": "https://your-outflow-domain.com",
           "OUTFLOW_API_KEY": "ofk_...",
           "OUTFLOW_WORKSPACE_ID": "your-workspace-id"
         }
       }
     }
   }
   

   ローカル開発の場合、OUTFLOW_BASE_URL を省略すると、デフォルトで http://localhost:3000 が使用されます。

ツール

ツール	質問できる内容
find_node	このファイルは追跡されていますか？ID は何ですか？
list_nodes	非推奨のノード、ヘルスが低いノード、または指定した種類のノードはありますか？
get_dependencies	このファイルは何に依存していますか？
get_impact	このファイルを変更すると何が壊れますか？（影響範囲）
find_path	この 2 つのファイルはどのようにつながっていますか？
get_architecture_health	全体のヘルスグレードとリスクのあるノードは何ですか？
find_architecture_smells	現時点で循環依存、巨大なノード、またはデッドコードはありますか？
get_architecture_graph	指定したズームレベルでグラフ全体を表示してください。
get_last_session_recap	直近のコーディングセッションでは何がありましたか？

path を受け取るツールはすべて部分一致に対応しています（例："ApiClient" は src/ApiClient.ts に一致します）。Outflow 内部の file::／method:: ID 形式を知る必要はありません。部分一致する候補が複数ある場合は、推測するのではなく、候補を一覧表示したエラーを返します。

補足

• このパッケージは単独で動作します。server/ や web/ にバンドルされることはなく、ビルド時にそれらへ依存しません。API キーを使って HTTP 経由で稼働中の Outflow インスタンスと通信するため、ローカルホストとデプロイ済みのインスタンスのどちらにも同様に接続できます。
• get_dependencies／get_impact と find_architecture_smells／find_path はワークスペースグラフのルートを呼び出します。このパッケージの導入時点で、これらのルートは既存の Cookie セッション認証に加えて Authorization: Bearer ofk_... も受け付けるよう拡張されています — server/src/graph/pathRouter.ts と smellsRouter.ts を参照してください。