Connectrylab Architect Cert MCP

Ace the Claude Certified Architect exam

Adaptive certification prep powered by the Model Context Protocol.

390 questions. Guided capstone build. 30 concept handouts. 6 reference projects. Practice exams. Interactive dashboard. Spaced repetition. Zero sycophancy.

Quick Start • Learning Path • Interactive Experience • Assessment • Handouts • Practice • Capstone Build • Practice Exams • Dashboard • Reference Projects • Tools • Architecture

______________________________________________________________________

什么是建筑师证书？

Architect Cert是一个免费的开源软件 主控程序 将Claude变成您的个人认证导师的服务器 克劳德认证建筑师——基础 考试。没有课程，没有幻灯片，没有视频讲座——只要问克劳德并学习。

它附带了：

• 390个基于场景的问题 涵盖所有5个考试领域和30个任务陈述
• 交互式可点击UI --用A/B/C/D按钮回答问题，选择后续行动，用复选框选择域——所有这些都在Claude内部
• 经验教训先行评估 --在测试之前学习每个领域的概念
• 引导式顶点构建 --塑造自己的项目，然后一步一步地构建它，同时亲自学习每个任务陈述
• 30份概念讲义 --每个任务语句一个，包含代码示例和常见错误
• 6个参考项目 --可运行的TypeScript代码库，在实践中演示每个领域
• 上机进行模拟考试 --60题加权考试，具有历史跟踪和改进趋势
• 进度仪表板 --glassmorphism可视化仪表板，显示掌握程度、考试历史图表、活动时间表
• 视觉进度跟踪 --todo清单通过评估、考试和顶点构建实时跟踪你的进度
• 互动式跟进 --错误答案？单击查看代码示例、概念课程、讲义或参考项目
• PDF生成 --带有建筑师证书标志的品牌讲义PDF，用于离线学习
• 间隔重复 --SM-2算法以最佳间隔安排审查
• 确定性分级 --纯函数分级，无LLM判断，零阿谀奉承

一切都在本地运行。没有云，没有账户，没有遥测。

快速开始

1.安装

npm install -g connectry-architect-mcp

2.配置您的MCP客户端

Claude Code — One-liner

claude mcp add connectry-architect -- connectry-architect-mcp

就是这样。重新启动Claude Code，服务器就会自动启动。

Claude Code — Manual config

增添 .mcp.json 在您的项目或 ~/.claude.json 全球地：

{
  "mcpServers": {
    "connectry-architect": {
      "command": "connectry-architect-mcp"
    }
  }
}

重新启动克劳德代码。当Claude加载时，服务器会自动启动。

Claude Desktop — macOS

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "connectry-architect": {
      "command": "connectry-architect-mcp"
    }
  }
}

提示： 如果你使用 nvm，您可能需要指定二进制文件的完整路径： ``json "command": "/Users/yourname/.nvm/versions/node/v22.20.0/bin/connectry-architect-mcp" ``

重新启动克劳德桌面。您将在聊天输入中看到MCP工具图标。

Claude Desktop — Windows

增添 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "connectry-architect": {
      "command": "connectry-architect-mcp"
    }
  }
}

重新启动克劳德桌面。您将在聊天输入中看到MCP工具图标。

Any MCP-compatible client

Architect-Cert可与任何支持 模型上下文协议。将其配置为stdio服务器：

• 命令： connectry-architect-mcp
• 论据： 无
• 运输： 标准

服务器公开了18个工具、8个提示和3种资源类型。

3.开始学习

重新启动MCP客户端并开始聊天：

学习路径

建筑师证书的设计遵循自然发展。以下是推荐的顺序：

1. Assessment        → Baseline your knowledge across all 5 domains
       ↓
2. Learn concepts    → Read handouts for weak domains before practicing
       ↓
3. Adaptive practice → Questions prioritized by weakness, reviews, new material
       ↓
4. Follow-ups        → Dive into code examples, concept lessons, reference projects
       ↓
5. Capstone build    → Build your own project covering all 30 task statements
       ↓
6. Practice exams    → Simulate the real exam (60 questions, scored out of 1000)
       ↓
7. Review & repeat   → Dashboard tracks mastery, spaced repetition handles scheduling

你可以在任何时候跳到任何阶段——系统会适应。但上面的路径给你最结构化的体验。

互动体验

Architect-Cert使用Claude内置的交互式UI，让学习感觉自然。无需输入回信，只需点击即可。

可点击的答案选择

每个问题都会出现 可点击的A/B/C/D按钮 直接在克劳德。您点击答案而不是键入。如果问题中包含场景中的代码 代码预览 显示在每个选项旁边，以便您在决定时参考它。

后续行动

每次回答后，都会出现可点击的后续按钮：

在错误答案之后：

• 明白了，下一个问题
• 用代码示例解释
• 给我看概念课
• 给我看看讲义
• 在参考项目中显示我

在正确答案之后：

• 下一个问题
• 解释为什么其他人错了

多选域选择器

在申请学习计划时，您可以选择多个领域来集中使用 复选框 --无需一一列举。

视觉进度检查表

评估（15个问题）、练习考试（60个问题）和顶点构建（18个步骤）等长流程创建了一个 视觉整体检查表 随着你的进步，它会实时更新。你总是知道你在哪里，还剩下什么。

跳过及其他

每个问题选择都包括 跳过 继续前进的按钮和 其他 提出自由形式问题的选项。如果你用“其他”来提问，克劳德会回答你的问题，然后 重新呈现相同的测验问题 --你永远不会失去你的位置。“跳过”转到下一个问题；跳过的问题仍未得到解答，稍后将再次出现。

初步评估

从a开始 15个问题诊断 （每个域3个），这决定了你的学习路径。评估与原始实践不同：

课程第一流

当评估达到 新领域 它第一次停下来向您展示 概念讲义 在提问之前。这意味着您将学习关键思想，查看代码示例，并了解常见错误 *之前* 正在接受测试——不要盲目猜测。

每个域的流程：

1. 显示概念讲义（每个域一次）
2. 一次提出3个问题（简单、中等、困难）
3. 每个答案都立即评分并附有解释
4. 移动到下一个域

路径分配

根据您的总体准确度：

进度跟踪

评估创建了 15项目视检查表 （Q1至Q15，按域分组），在每个答案后更新。你总是能清楚地看到自己进步了多远。

概念讲义

每个任务陈述都有一个 概念讲义 --一份结构化的研究文件（约500-800字），涵盖：

• 概念 --核心思想、思维模式以及何时/为什么使用它
• 代码示例 --演示模式的真实TypeScript
• 常见错误 --3-5个最常见的错误（对应于考试错误答案）
• 参考文献 --Anthropic官方文件的链接

阅读克劳德讲义

You: "Show me the handout for task 2.3"

Claude: [loads the full handout with concept, code, mistakes, references]

当讲义自动出现时

• 评估期间 --显示在每个新域的第一个问题之前
• 在一个错误的答案之后 --“给我看看讲义”是后续选项之一
• 在顶点构建过程中 --每个构建步骤都有相关的讲义

生成PDF讲义

为离线学习的所有30份讲义生成品牌PDF：

cd connectrylab-architect-cert-mcp
npm run generate:pdfs

这将在中创建30个PDF generated/handouts/ 与：

• 标题中的建筑师证书徽标和域标签
• 使用语法突出显示的代码块进行干净的格式设置
• “Connectry LABS-Claude认证建筑师考试准备——免费开源”页脚

适应性实践

每个练习题都由 三优先级算法:

1. 逾期评论 --今天需要审查的间隔重复项目
2. 薄弱环节 --掌握率低于50%的主题
3. 新材料 --来自您推荐域名的新问题

过滤

您可以按领域和/或难度筛选练习题：

You: "Give me a hard question about prompt engineering"

Claude: [presents a hard Domain 4 question with clickable A/B/C/D buttons]

互动式跟进

每次回答后，您都会看到可点击的后续选项。每个选项都深入到概念中，然后让你回到你的测验中。你从不离开你的学习流程去查东西。

掌握水平

30个任务陈述中的每一个都有一个独立的掌握水平：

间隔重复（SM-2）

这 SM-2算法 计划审查间隔：

• 第一次审查： 回答后1天
• 第二次审查： 首次审核后3天
• 后续审查： 前一个间隔x缓解系数（从2.5开始）
• 错误答案： 间隔重置，易用系数降低0.2（下限：1.3）
• 正确答案： 易用系数增加0.1

难题经常出现。简单的间隔数周或数月。

引导式拱顶石建造

最实用的学习方法——从头开始构建自己的项目，同时涵盖所有30个任务陈述。你不只是回答问题，而是根据自己的想法构建一个真正的系统。

运作原理

顶点构建有三个阶段：

第一阶段——项目塑造

您描述了一个项目想法（例如，“多代理代码审查系统”）。Claude根据所有30个架构标准分析你的想法，并找出差距。你们一起改进，直到涵盖了每个任务陈述。

You: "I want to start a guided capstone build"

Claude: [presents the 30 criteria across all 5 domains]
        Describe your project idea and I'll analyze coverage.

You: "A multi-agent code review system that analyzes PRs"

Claude: Your idea naturally covers 24/30 criteria. To cover the
        remaining 6, I'd suggest adding: [specific suggestions
        mapped to task statements]

第2阶段——交错构建（18个步骤）

每一步都遵循相同的模式：

1. 测验 --关于你即将构建的任务陈述的2-3个问题（可点击A/B/C/D）
2. 构建 --Claude生成文件的代码，以您的项目为主题
3. 攻略 --逐行解释将代码映射到任务语句

A. 视觉18步检查表 实时跟踪您的进度。

这18个步骤逐步构建：

每个测验答案都会与常规练习一样，以相同的间隔重复和掌握跟踪。

第3阶段——最终审查

在步骤18之后，您将获得一个完整的覆盖图：所有30个任务语句，每个语句都在您的项目中演示，以及每个域的测验表现。薄弱环节被标记为进一步研究。

Capstone构建工具

它如何连接到其他一切

• 构建过程中的测验答案使用相同的答案 submit_answer 分级和SM-2调度
• 在任何测验问题之后，您都可以使用相同的后续选项（代码示例、概念课、讲义、参考项目）
• 参考项目显示了完成后顶层结构的外观
• 进度在各个会话中都保持不变——从你停止的地方继续

练习考试

模拟真实认证的完整60道题考试：

所有尝试都会保存为每个域的分数细分和改进趋势。

进度仪表板

建筑师证书包括 glassmorphism视觉仪表板 通过Claude Preview直接在Claude内部渲染。

它显示了什么

• 准备就绪戒指 --循环进度指标中的整体考试准备百分比
• 域主控网格 --每个考试域有5张带进度条的卡片
• 考试历史图表 --绘制随时间变化的模拟考试成绩的折线图，标记720分通过
• 最近活动时间表 --您最后10个答案的正确/不正确指标
• 顶点进度 --当前构建步骤和完成百分比
• 快速操作按钮 --跳到练习、考试、学习计划或顶点

如何打开

You: "Show my dashboard"

Claude: [opens the branded dashboard in Claude Preview]

通过再次询问Claude，可以随时重新打开仪表板。它总是反映你的最新数据。

文本回退

对于不支持Claude Preview的MCP客户端，仪表板工具也会返回 文本摘要 掌握百分比和考试统计数据。

参考项目

建筑师证书包括 6个完整的参考项目 --可运行的TypeScript代码库，在真实代码中演示认证概念。每个文件都有一个标题注释，将其映射到特定的任务语句。

如何访问

You: "Show me a reference project for domain 1"

Claude: [returns the project README, file listing, and architecture walkthrough]

他们如何连接到学习流程

当你问错问题时，后续选项之一是 “在参考项目中显示我” --这将带您直接进入相关的领域项目，这样您就可以看到在实际代码中实现的概念。然后你跳回你的测验。

学习计划

根据你的表现、考试权重和间隔重复时间表获得个性化的学习建议。

多选域焦点

在申请学习计划时，您可以选择特定的领域来重点使用 复选框:

You: "What should I study next?"

Claude: [shows domain checkboxes — select the ones you want to focus on]
        [generates a personalized study plan with a visual checklist]

研究计划创建了一个 目视检查表 这样你就可以通过每个推荐来跟踪你的进度。

考试域名

克劳德认证建筑师基础考试涵盖5个领域：

30任务陈述

Domain 1 — Agentic Architecture & Orchestration (7 tasks, 91 questions)

Domain 2 — Tool Design & MCP Integration (5 tasks, 65 questions)

Domain 3 — Claude Code Configuration & Workflows (6 tasks, 78 questions)

Domain 4 — Prompt Engineering & Structured Output (6 tasks, 78 questions)

Domain 5 — Context Management & Reliability (6 tasks, 78 questions)

工具

建筑师证书提供 18个MCP工具 Claude用来提供学习体验的工具：

学习流程

进度与规划

练习考试

Capstone构建

参考&管理

服务器也进行了注册 8个交互式提示 和 3种资源类型 （概念讲义、参考项目、考试概述）。

建筑

┌──────────────────────────────────────────────────────────────────────┐
│                           YOUR MACHINE                               │
│                                                                      │
│   ┌──────────────┐       ┌────────────────────────────────┐          │
│   │ Claude Desktop│       │     Architect Cert MCP          │          │
│   │ Claude Code   │◄─────►│                                │          │
│   │ Any MCP client│ stdio │  18 tools                      │          │
│   └──────┬───────┘       │   8 prompts                     │          │
│          │                │   3 resource types              │          │
│          │                └──────────┬─────────────────────┘          │
│          │                           │                                │
│          │         ┌────────────────┼────────────────────┐           │
│          │         │                │                     │           │
│          │   ~/.connectry-      390 questions         6 reference     │
│          │    architect/       30 handouts            projects        │
│          │    progress.db     (bundled JSON/MD)      (bundled TS)     │
│          │                                                            │
│          │  ┌──────────────────────────┐                              │
│          └──► Claude Preview (Dashboard) │                              │
│             │ localhost HTTP server      │                              │
│             └──────────────────────────┘                              │
│                                                                      │
└──────────────────────────────────────────────────────────────────────┘

核心组件

交互式UI架构

Architect-Cert不会构建自己的聊天UI。相反，它指示克劳德使用 内置交互式工具:

• 询问用户问题 --显示用于A/B/C/D答案、后续操作和域选择的可点击按钮。支持单选（单选按钮）、多选（复选框）和通过“其他”输入自由文本。
• TodoWrite --创建可视化进度清单，在评估、考试和顶点构建过程中实时更新。
• 克劳德预览 --在本地HTTP服务器上呈现glassmorphism仪表板HTML。

这种方法适用于Claude Code和Claude Desktop，无需在客户端使用任何自定义UI代码。

防粘连设计

此服务器在协议级别强制执行诚实分级，而不仅仅是在提示中：

1. 确定性分级 — gradeAnswer() 这是一个纯粹的函数。没有法学硕士参与判断正确性。
2. 工具级执行 --The submit_answer 工具描述指示Claude逐字传递结果。
3. 无部分信用 --多项选择，一个正确答案。不，“你走对了路。”
4. 错误答案解释 --每个错误的选项都有一个特定的 whyWrongMap 解释误解的条目。
5. 系统提示规则 --五项反阿谀奉承指令防止克劳德软化不正确的结果。

题库详细信息

数据存储

• 进度存储在本地 ~/.connectry-architect/progress.db （SQLite，WAL模式）
• 您的用户配置位于 ~/.connectry-architect/config.json （首次运行时自动创建）
• 没有云，没有账户，没有遥测——一切都留在你的机器上

贡献

我们欢迎捐款！以下是如何开始：

# Clone the repo
git clone https://github.com/Connectry-io/connectrylab-architect-cert-mcp.git
cd connectrylab-architect-cert-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Generate PDF handouts
npm run generate:pdfs

# Run locally
node dist/index.js

项目结构

src/
├── index.ts              # MCP server entry point
├── config.ts             # User config management
├── types.ts              # All TypeScript interfaces
├── data/
│   ├── loader.ts         # Lazy-cached data loading
│   ├── curriculum.json   # 30 task statements
│   ├── questions/        # 390 questions (5 domain files)
│   ├── handouts/         # 30 concept handouts (markdown)
│   ├── criteria.ts       # 30 task statement criteria for capstone validation
│   ├── build-steps.ts    # 18 capstone build step definitions
│   └── system-prompt.ts  # Anti-sycophancy rules
├── db/
│   ├── schema.ts         # SQLite schema (9 tables)
│   ├── store.ts          # Database initialization
│   ├── mastery.ts        # Mastery level calculations
│   ├── answers.ts        # Answer recording
│   ├── review-schedule.ts # SM-2 review scheduling
│   ├── capstone.ts       # Capstone build CRUD operations
│   ├── users.ts          # User management
│   └── exam-attempts.ts  # Practice exam tracking
├── engine/
│   ├── grading.ts        # Deterministic grading
│   ├── spaced-repetition.ts  # SM-2 algorithm
│   ├── question-selector.ts  # Priority-based selection
│   ├── exam-builder.ts       # Practice exam generation
│   └── adaptive-path.ts      # Learning path recommendations
├── tools/                # 18 MCP tool handlers
│   ├── index.ts          # Tool registration
│   ├── elicit.ts         # MCP elicitation helper (graceful fallback)
│   ├── start-assessment.ts
│   ├── submit-answer.ts
│   ├── get-practice-question.ts
│   ├── follow-up.ts
│   ├── get-progress.ts
│   ├── get-curriculum.ts
│   ├── get-section-details.ts
│   ├── get-weak-areas.ts
│   ├── get-study-plan.ts
│   ├── start-practice-exam.ts
│   ├── submit-exam-answer.ts
│   ├── get-exam-history.ts
│   ├── scaffold-project.ts
│   ├── start-capstone-build.ts
│   ├── capstone-build-step.ts
│   ├── capstone-build-status.ts
│   ├── reset-progress.ts
│   └── dashboard.ts
├── ui/
│   ├── server.ts         # Dashboard HTTP server
│   ├── dashboard.html    # Glassmorphism dashboard UI
│   ├── meta.ts           # Quiz widget metadata
│   └── loader.ts         # HTML asset loader
├── prompts/              # 8 MCP prompt definitions
└── resources/            # 3 MCP resource types

projects/
├── capstone/             # All 5 domains — multi-agent support system
├── d1-agentic/           # Domain 1 — agentic loop research coordinator
├── d2-tools/             # Domain 2 — MCP server with tool patterns
├── d3-config/            # Domain 3 — Claude Code configuration layout
├── d4-prompts/           # Domain 4 — extraction & prompt engineering
└── d5-context/           # Domain 5 — context management & reliability

scripts/
└── generate-pdfs.ts      # PDF handout generator

许可证

MIT© Connectry实验室

学分

• Anthropic --克劳德和克劳德认证建筑师认证计划
• 模型上下文协议 --使这成为可能的协议
• 更好平方3 --用于Node.js的快速同步SQLite

______________________________________________________________________

Built with care by Connectry Labs

GitHub • npm • Architect Cert • Connectry Labs