Arkitect Mcp

Arkitect 单体仓库基础

Arkitect 现已搭建为真正的 pnpm + turbo + TypeScript 单体仓库，同时保留了仓库根目录中的原始产品规格 Markdown 文件。

下载

选项	链接
网站（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 registry。

工作区布局

• apps/desktop：可选的本地 Electron 工作台（不提供 Windows 安装程序）。
• apps/site：React 营销网站（开源 + 可选的 Buy Me a Coffee），与桌面优先的产品方向保持一致。
• apps/licensing-worker：Cloudflare Worker 脚手架，用于接收 Stripe webhook 以及验证权益和许可证的路由。
• packages/contracts：共享的诊断、目录、AI、许可和 MCP 结果契约。
• packages/core：编码后的架构／改造／模式库，以及以架构为先的决策逻辑和推荐评分。
• packages/design-system：供桌面和网站界面共用的 Arkitect 深色主题令牌。
• packages/ai：与提供商无关的 AI 目录，推荐默认使用 Composer 2.5。
• packages/repo-analyzer：模拟仓库分析器，展示平台、工作负载、架构、健康状况和意图检测的处理流程。
• packages/mcp-server：面向 MCP 的诊断载荷和工具定义脚手架，供 Cursor 等客户端使用。
• 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

当前脚手架状态

• Monorepo 结构和工作区包已就绪，但实际代码仍然很少。
• 共享架构、重构和设计模式目录现已编码在 packages/contracts、packages/core、packages/mcp-server 和 apps/desktop 中。
• 桌面应用现已提供可交互的 Phase 2 工作台：步骤导航、本地仓库测试流程、预设的增删改查、带标签页的结果，以及本地 JSON 持久化。
• AI 设置现将默认凭据描述为 Cursor API Key，并将 composer-2.5 列为推荐的 Composer 系列模型／构建版本。
• 仓库分析器仍是模拟分析器，尚未深入扫描文件系统。
• 许可工作器使用占位路由行为，尚未验证 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 打包。