Arkitect Mcp

Arkitect モノレポの基盤

Arkitect は、リポジトリのルートに元の製品仕様の Markdown ファイルを保持したまま、pnpm + turbo + TypeScript を使用する本格的なモノレポとして足場が整いました。

ダウンロード

オプション	リンク
ウェブサイト（mcp.json のインストール）	arkitect-mcp.com
ユーザーガイドと MCP のセットアップ	arkitect-mcp.com/instructions
GitHub ソース	github.com/ezequielcasillas1/Arkitect-MCP.AI

インストール： このリポジトリをクローンし、@arkitect/mcp-server をビルドしてから、arkitect-mcp.com の .cursor/mcp.json を貼り付けます。Windows インストーラーはありません。npm レジストリも使用しません。

ワークスペースの構成

• apps/desktop：オプションのローカル Electron ワークベンチ（配布用の Windows インストーラーではありません）。
• apps/site：デスクトップ優先の製品方針に沿った React マーケティングサイト（オープンソース + オプションの Buy Me a Coffee）。
• apps/licensing-worker：Stripe の Webhook 受信と、利用資格／ライセンス検証ルートを備えた Cloudflare Worker の足場。
• packages/contracts：診断、カタログ、AI、ライセンス、MCP の結果に関する共有コントラクト。
• packages/core：エンコードされたアーキテクチャ／リミックス／パターンライブラリと、アーキテクチャ優先の意思決定ロジックおよび推奨スコアリング。
• packages/design-system：デスクトップとサイトの各画面で共有する、Arkitect のダークテーマ用トークン。
• packages/ai：プロバイダーに依存しない AI カタログ。Composer 2.5 を推奨のデフォルトとしています。
• packages/repo-analyzer：プラットフォーム、ワークロード、アーキテクチャ、健全性、意図の検出がどのように連携するかを示すモックのリポジトリアナライザー。
• packages/mcp-server：Cursor などのクライアント向けに、診断ペイロードとツール定義を MCP 対応用に用意した足場。
• packages/github：後から情報を拡充するための、ローカルファーストな GitHub 健全性ブリッジのプレースホルダー。

足場に組み込まれた製品の動作

1. Arkitect はまずリポジトリをスキャンし、プラットフォーム、ワークロード、アーキテクチャ、リポジトリの健全性、推定される意図について、自動検出したシグナルを提示します。
2. デスクトップダッシュボードでは自動検出された値を表示したまま、ユーザーによるヒント、確認、上書きを可能にします。
3. 検出の確度が十分に高い場合、健全な既存のアーキテクチャをそのまま継続します。
4. 健全でない構造やスパゲッティ構造はまず報告し、明示的な構造変更の意図と許可がない限り、自動でリファクタリングしません。
5. MCP ペイロードでは、デスクトップシェルに表示されるものと同じ結果形式を使用して、診断コンテキスト、判断、Cursor 向けガイダンスを公開します。

ツール

• パッケージマネージャー：pnpm
• タスクランナー：turbo
• フロントエンドアプリ：Vite + React
• デスクトップシェル：Electron
• Worker ランタイム：Cloudflare Workers
• 共有言語／ツール：TypeScript + ESLint

ユーザーガイド

マーケティングサイト、Supabase のセットアップ、MCP サーバーの設定、一般的なワークフローについての詳しいチュートリアルは、docs/USER_GUIDE.md をご覧ください。

コマンド

モノレポのルートから実行します（例：C:\Dev\Arkitect-mcp.com）。

cd C:\Dev\Arkitect-mcp.com
pnpm install
pnpm build
pnpm typecheck
pnpm lint
pnpm verify
pnpm dev:desktop
pnpm start:desktop
pnpm dev:site
pnpm dev:worker

または、リポジトリのルートに cd してから、個別のスクリプトを実行します。

• pnpm install
• pnpm build
• pnpm typecheck
• pnpm lint
• pnpm verify
• pnpm dev:desktop
• pnpm start:desktop
• pnpm dev:site
• pnpm dev:worker

現在のスキャフォールドの状況

• モノレポ構造とワークスペースパッケージが存在し、実際のコードは最小限です。
• 共有アーキテクチャ、リミックス、デザインパターンのカタログは、packages/contracts、packages/core、packages/mcp-server、apps/desktop にエンコードされています。
• デスクトップアプリには、ステップナビゲーション、ローカルリポジトリのテストフロー、プリセットの CRUD、タブ付きの結果表示、ローカル JSON 永続化機能を備えた、インタラクティブな Phase 2 ワークベンチが追加されました。
• AI 設定では、デフォルトの認証情報が Cursor API Key とされ、Composer 系モデル／ビルドとして composer-2.5 が推奨されています。
• リポジトリ分析機能はまだモックアナライザーで、ファイルシステムの詳細なスキャンには対応していません。
• ライセンスワーカーはプレースホルダーのルート動作を使用しており、Stripe 署名の検証やライセンス権限の永続化にはまだ対応していません。
• MCP サーバーは診断構造とツールのスキャフォールドをエクスポートしますが、公式 MCP SDK のトランスポート層にはまだ接続されていません。

エンコード済みカタログライブラリ

• packages/contracts：カタログの型、スコアリングのコントラクト、診断結果の形式。
• packages/core：具体的なアーキテクチャカタログ、リミックスプロファイル、デザインパターン、推奨エンジン。
• packages/mcp-server：アーキテクチャ、リミックス、パターン、診断ペイロード向けの MCP 対応リストツール／リソース。
• apps/desktop：診断フローに表示されるカタログ、リミックスの選択、パターン DNA。

次の実装手順

1. モックのリポジトリ分析を、ファイルシステムとリポジトリメタデータのスキャンに置き換えます。
2. Cloudflare ワーカールート向けに、永続化されるライセンスおよびメンバーシップのストレージを追加します。
3. デスクトップシェルを、より詳細なバックグラウンド分析ジョブと実際の実行パイプラインに接続します。
4. 外部クライアントから直接呼び出せるよう、MCP サーバーにトランスポート／ランタイムの接続処理を追加します。

デスクトップでのローカルテスト

1. リポジトリのルートから実行します。

cd C:\Dev\Arkitect-mcp.com
pnpm dev:desktop

2. アプリで Connect Repo を使って別のローカルフォルダーを参照するか、Windows パスを手動で貼り付けます。
3. Inspect path をクリックして診断ステップを進み、ローカルで結果フローを実行します。
4. pnpm build の後、リポジトリのルートから pnpm start:desktop を実行すると、Windows Store 向けのパッケージ化なしでビルド済みデスクトップアプリを開けます。