Archiet Xray

Archiet X-Ray

mcp-name: io.github.Anioko/archiet-xray

AI が何を見ているかを確認できます。 コードベースが大きすぎて、AI エージェントのコンテキストウィンドウには収まりません。エージェントが 4,000 ファイルのうち 40 ファイルを読み、変更を加えても、アーキテクチャを守ったのか、それとも気付かないうちに違反したのかを知る方法がありません。

X-Ray は、あらゆるリポジトリの実際のアーキテクチャを決定論的に抽出します。LLM は使わず、コードがマシンの外に出ることもありません。その結果をあなた（インタラクティブなマップ）とAI エージェント（MCP サーバーとコンテキストパック）の両方に提供します。

$ python xray.py .

Archiet X-Ray v0.2.0 — your-repo
  visibility score : 78/100
  prod readiness   : 71/100 (near production-ready)
  code files       : 3,412 (1,907 read, 1,584 with elements)
  routes           : 214
  entities         : 87
  async tasks      : 31
  findings         : 6
  wrote            : .archiet/ARCHITECTURE.md
                     .archiet/AGENT_CONTEXT.md
                     .archiet/architecture.json
                     .archiet/diagrams/diagrams.html (+3 .mmd)

得られるもの

ファイル	内容
ARCHITECTURE.md	人が読めるマップ：モジュール依存関係グラフ（Mermaid）、ドメインモデル、認証ステータス付きの全ルート、依存関係のホットスポット、リスクに関する指摘、本番対応スコアカード
AGENT_CONTEXT.md	CLAUDE.md またはルールファイルに追加すると、Claude Code、Cursor、Windsurf が今日からアーキテクチャを尊重するようになります
architecture.json	機械可読なモデル（「リポジトリのゲノム」）
diagrams/	Mermaid ソースとしてのアーキテクチャ図と、自己完結型の HTML ビューアー：モジュール依存関係グラフ、ER／ドメインモデル図、HTTP ルートマップ

本番対応スコア（0.2 の新機能）

8 つの側面を対象とする、決定論的な0～100 の本番対応スコアです。 ルートの認証カバレッジ、シークレットの管理、クライアント側のトークン保存、データ層の規律、テストの実施状況、マイグレーションの規律、運用対応状況（Docker／CI／.env の契約）、ドキュメント／API の契約を評価します。同じリポジトリなら常に同じスコアになるため、コミット、ブランチ、リポジトリ間で比較でき、CI に組み込むこともできます。

各側面では根拠を示します（「静的に保護されている 214 ルートのうち 142 ルートに認証ガードが設定されています」）。レポートの最後には、失点数に基づいて順位付けされた、優先度の高い修正項目が表示されます。適用されない側面（ルートを持たない CLI ツールなど）には半分の点数を与え、その旨を明示します。お世辞ではなく、正直な評価を重視しています。

次のような場合に役立ちます：リリース前の AI 生成コードのレビュー、引き継いだコードベースの監査、またはリポジトリが時間とともに本番対応の水準から逸脱していないかの追跡。

コードからアーキテクチャ図を生成（0.2 の新機能）

generate_diagrams は、コードそのものから決定論的に抽出したMermaid アーキテクチャ図に、あらゆるリポジトリを変換します。

• モジュール依存関係グラフ — wiki ではなく、実際のインポート構造
• ER／ドメインモデル図 — SQLAlchemy、Django、Prisma モデルからエンティティと関連を抽出
• HTTP ルートマップ — プレフィックスごとにグループ化した API サーフェス

生の .mmd ソース（README、wiki、GitHub、GitLab、Notion、Obsidian、VS Code などに貼り付けて使えます。どれも Mermaid をネイティブにレンダリングします）に加えて、自己完結型の diagrams.html ビューアーも利用できます。

エージェントに渡す（MCP）

# Claude Code (from PyPI — pip install archiet-xray)
claude mcp add archiet-xray -- archiet-xray mcp /path/to/repo

# or from a checkout
claude mcp add archiet-xray -- python /path/to/mcp_server.py /path/to/repo

Claude Desktop — 最新リリースから archiet-xray-<version>.mcpb をダウンロードし、ダブルクリックします（または、Settings → Extensions → Install Extension を選択します）。解析するリポジトリを指定すれば、あとはワンクリックで完了します。

公式 MCP レジストリ — io.github.Anioko/archiet-xray として登録されているため、レジストリに対応したクライアントは名前でインストールできます。

エージェントは変更を加える前に、次のように問い合わせられるようになります。

• blast_radius — 「このファイルに依存しているのは誰ですか？ 変更すると何が壊れますか？」
• arch_summary — 「ルート／エンティティ／サービスは実際にはどこにありますか？」
• boundary_findings — 「ハードコードされたシークレット、生の SQL、localStorage に保存されたトークン、認証されていないルートはありますか？」
• production_readiness — 「根拠と優先度の高い修正項目を添えて、このリポジトリの本番対応度を 0～100 で評価してください」
• generate_diagrams — 「モジュールグラフ／ER 図／ルートマップを Mermaid で描いてください」
• xray_scan — 構造を変更した後に再スキャンします

原則

1. 決定論的です。 同じリポジトリを入力すれば、同じマップが出力されます。すべての事実はファイルと行番号を特定できます。パイプラインのどこにも LLM による推測はありません。
2. 誠実です。 確信を持って抽出できない情報には、決して捏造せず、未マッピング のラベルを付けます。誤ったマップより、マップがないほうがましです。
3. ローカル優先です。 標準ライブラリのみを使い、ネットワーク呼び出しもテレメトリーもありません。コードがマシンの外に出ることはありません。

現在抽出できる情報

• Python：Flask／FastAPI のルート（認証ガードの検出を含む）、関連を持つ SQLAlchemy と Django のモデル、Celery タスク、インポートグラフを、正規表現ではなく ast で抽出します
• JS/TS：Next.js の app router と pages router（ページと API ルート）、Express のルート、Prisma モデル、インポートグラフ
• 検出事項：ハードコードされたシークレット、ORM を迂回する生 SQL、localStorage／AsyncStorage 内の認証トークン、認証ガードのないルート
• グラフ：モジュール間の依存関係エッジ、ファンイン／ファンアウト、影響範囲の大きいホットスポット

さらに多くのスタック（Go、Java、Rails、.NET）にも対応したいと考えています。抽出パターンは言語ごとに 1 クラスです。PR をお待ちしています。

実例

examples/ には、よく知られたリポジトリでの未編集の X-Ray 出力があります。microblog（Flask）、公式の FastAPI フルスタックテンプレート、vercel/commerce（Next.js）が含まれます。GitHub では Mermaid のマップがインラインで表示されます。FastAPI テンプレートでは、X-Ray は 18 個のルートで CurrentUser 依存関係による認証を正しく検出し、useAuth.ts 内の実際の認証トークンの localStorage 書き込みに警告を出します。

よくある質問

依存関係グラフを表示する MCP サーバー（Codegraph、dependency-mcp）とは何が違いますか？ これらは呼び出し／インポートのエッジを表示します。X-Ray はグラフの上に Web アーキテクチャのセマンティクス を抽出します。どのルートが存在するか、どのルートに認証ガードがあるか、ドメインエンティティがどこにあるか、セキュリティ境界がどこで漏れているか（ハードコードされたシークレット、生 SQL、localStorage 内のトークン）が分かります。「510 個のルートに検出可能な認証ガードがありません」と教えてくれるグラフツールはありません。

CLAUDE.md ジェネレーターとは何が違いますか？ CLAUDE.md ジェネレーターは 指示や規約 を、通常は LLM を使って記述します。X-Ray が抽出するのは 事実 です。出力内のすべての主張はファイルと行番号を特定でき、抽出できない情報には不明のラベルを付けます。両方を使ってください。規約に X-Ray の確かな情報を組み合わせられます。

認証ステータス ? は何を意味しますか？ 「関数ごとの分析では検出できません」という意味です。FastAPI のルーターでは、include_router(dependencies=...) のレベルで認証が設定されることが多く、ルート関数を分析しても確認できません。X-Ray は確信を持って「認証なし」と推測せず、不明として報告します。誤ったマップより、マップがないほうがましです。

本番環境対応スコアはセキュリティ監査ですか？ いいえ。これは決定論的な静的シグナルのスコアです。リポジトリに本番運用の規律を示す要素（ルートの認証ガード、ハードコードされたシークレットがないこと、テスト、マイグレーション、運用とドキュメントに関する契約）が 備わっているか を評価します。出力にはその旨が明記されています。迅速で再現可能なトリアージ用の数値であり、コードレビュー、負荷テスト、セキュリティ監査の代わりにはなりません。

図に画像ではなく Mermaid を使うのはなぜですか？ Mermaid のソースは差分を確認でき、GitHub／GitLab／Notion／VS Code／Obsidian でネイティブにレンダリングされ、1 つのコマンドで再生成できるためリポジトリとの同期を維持できます。同梱の diagrams.html を使えば、何もインストールせずにブラウザーで表示できます。

外部に接続しますか？ いいえ。標準ライブラリのみを使い、ネットワーク呼び出しもテレメトリーもありません。外部に送信されるものがあるとすれば、生成されたフッター内のリンクだけです。

関連サーバー：archiet-audit

X-Ray はネットワークに一切アクセスしません。ホスト型 の代替サービスとして、アーキテクチャ文書から生成される調達基準に対応したアーキテクチャ監査（トレーサビリティ率、重大度順のギャップ、30／60／90 日のロードマップ）を利用したい場合は、archiet-audit MCP サーバー がエージェントと archiet.com/audit-my-architecture を連携します。X-Ray の「コードがマシンの外に出ることはありません」という保証を絶対に維持するため、これは別のサーバーとして提供されています。

プライバシーポリシー

X-Ray は設計上、ローカルのみで動作します。具体的には、以下のとおりです。

• データ収集：ありません。 X-Ray はテレメトリー、分析データ、利用データ、個人情報を一切収集しません。
• データの使用：ローカルでの分析のみです。 お使いのコードは、アーキテクチャモデルの構築のみを目的として、お使いのマシン上でプロセス内からディスク経由で読み取られます。
• データの保存：お使いのディスク上で、お客様が管理します。 生成される成果物は、スキャン対象のリポジトリ内の .archiet/ に書き込まれるファイル（ARCHITECTURE.md、AGENT_CONTEXT.md、architecture.json、diagrams/）のみです。これらはいつでも削除でき、ほかの場所には何も保存されません。
• 第三者との共有：ありません。 X-Ray はネットワーク通信を一切行いません（標準ライブラリのみを使用し、HTTP クライアントもインポートしません）。お使いのコードがマシンの外に出ることはありません。
• データの保持：該当しません。 当社にデータが届くことはないため、保持または削除するデータはありません。
• お問い合わせ先： [email protected] — または、このリポジトリで issue を作成してください。

archiet.com/privacy に記載されている会社全体のポリシーは、Archiet のホスト型製品を対象としています。X-Ray に適用されるのは、X-Ray が当社に何も送信しないという、限定的な意味においてのみです。

Archiet の一部

X-Ray は、アーキテクチャからコードを生成するプラットフォームである Archiet の、無料でオープンなコンパニオンです。X-Ray が抽出するマップは、Archiet がすべての PR でアーキテクチャを適用するために使用するものと同じ形式モデルです（境界ゲート、ドリフトのスコアリング、コンサルティング品質のアーキテクチャレポート）。また、このモデルから本番環境対応のアプリケーションを再生成するためにも使用されます。

MIT ライセンス。