AI导哈

规范架构服务器

Universal Spec Architect 是一款 MCP 服务器，用于强制执行规范的工程流程，适用于 AI 编码助手如 IBM Bob，确保在编写代码前完成需求、设计和任务规划。

  • by ahmedelpannann
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ahmedelpannann/bob-a-thon-submission

使用说明

通用规范架构师——IBM Bob-a-thon提交

项目目的

这 通用规范架构师 是一个MCP（模型上下文协议）服务器，旨在为IBM Bob等AI编码助手实施严格的、规范驱动的工程工作流程。

它解决的核心问题是，人工智能助手在没有适当规划的情况下直接编写代码，导致架构漂移、遗漏需求和无法维护的代码库。这个项目迫使助手在编写一行实现代码之前暂停、思考和记录。

主要特点

  • 强制三阶段工作流程：要求助理填写要求→ 设计→ 编码前的任务。
  • EARS符号验证：自动验证所有需求是否遵循需求语法的简易方法([WHEN <trigger>] THE <system> SHALL <response>).
  • 实时任务跟踪：为助手提供更新任务状态的工具(todo, in_progress, completed)在一个集中 tasks.md 文件。
  • IBM Bob集成：包括自定义 .bob/modes/spec-architect.json 和 .bob/rules/spec-workflow.md 与IBM Bob的转向机制无缝集成。
  • 通用兼容性：不仅适用于IBM Bob，还适用于Cline、Cursor、VS Code（Copilot）、Windsurf和Claude Desktop。

技术实现

该项目是使用基于Python的MCP服务器构建的 fastmcp 框架。

它向AI助手展示了6个核心MCP工具：

  1. initialize_spec：脚手架 .specs/ 目录结构。
  2. write_requirements：验证并写入 requirements.md.
  3. write_design：结构和写作 design.md.
  4. write_tasks：将工作分解为 tasks.md.
  5. update_task_status：动态修改任务状态。
  6. run_hook：执行生命周期挂钩(pre_task, post_task).

服务器在本地运行，并使用MCP协议通过stdio与IBM Bob通信。

如何在本地运行应用程序

先决条件

  • Python 3.11+
  • uv 已安装包管理器

安装

  1. 克隆此存储库。
  2. 安装依赖项：
    pip install fastmcp pydantic
pip install -e .

与IBM Bob一起运行

  1. 复制 .bob/ 将此存储库中的目录添加到目标项目的根目录中。
  2. 确保 .bob/mcp.json 指向正确的服务器路径：
    {
  "mcpServers": {
    "universal-spec-architect": {
      "command": "uvx",
      "args": ["fastmcp", "run", "src/universal_spec_mcp/server.py"],
      "env": { "PYTHONPATH": "src" }
    }
  }
}
  3. 在启用IBM Bob扩展的VS Code中打开您的项目。
  4. 选择 规范建筑师 模式在鲍勃。
  5. 让Bob“构建一个新功能”——Bob将自动启动MCP服务器并开始3阶段工作流。

运行测试

要在本地验证MCP服务器逻辑：

python3 tests/test_server.py

演示视频

在最终提交给IBM Bob-A-thon组织之前，将向此存储库添加一个3分钟的演示视频。该视频将涵盖：

  • 项目结构演练
  • IBM Bob Spec Architect模式正在运行
  • 生成的规范工件（需求、设计、任务）
  • 在本地运行测试套件

相关 MCP