@aisdlc/ mcp (英语)
MCP 整合 大赦国际-SDLC,使得AI-SDLC的能力能够通过"模型背景协议"被曝光.
什么是AI-SDLC? (英语)?
AI-SDLC是一个AI-内生软件开发生命周期框架,其重点是将工程治理,可追溯性,质量控制引入AI辅助软件开发.
该框架包括以下方面的能力:
- 要求和规格
- 软件变化
- 核查
- 质量门
- 可追踪性
- 工程 KPIs
- AI辅助工作流程
- 代理工程
- MCP一体化
@aisdlc/mcp 为框架提供MCP集成层.
什么是MCP吗?
这个 示范背景协议(MCP) 提供了AI应用程序与外部工具和上下文互动的标准化方式.
AI-SDLC将MCP作为AI客户端与软件工程能力之间的集成机制.
安装
npm install @aisdlc/mcp
或与平按:
pnpm add @aisdlc/mcp
在AI-SDLC中的作用
该套件位于AI客户端和AI-SDLC核心之间:
AI client
│
│ MCP
▼
@aisdlc/mcp
│
▼
@aisdlc/core
│
▼
AI-SDLC engineering
capabilities
这种分离保持了MCP整合与基础核心能力的独立.
使用量
MCP包意在将AI-SDLC能力与MCP兼容的AI客户端或代理环境相融合时被使用.
关于命令行入口和本地AI-SDLC工作流程,参见 @aisdlc/cli。 。 。 .
运行服务器
启动 MCP 服务器 npx 或通过AI-SDLC CLI:
# Direct execution with npx
npx @aisdlc/mcp
# Or via the CLI
aisdlc mcp
客户端配置
1. 自动统包设置(aisdlc init(中文(简体) )
当您使用初始化仓库时 aisdlc init (或 npx @aisdlc/cli init)),框架 自动脚手架预配置 MCP 文件 用于所有支持的IDE和代理环境的从框中跳出,无论CI提供者或代理设置如何:
- 谷歌反重力/双子座CLI数字 :
antigravity.mcp.json - 视觉工作室代码/副驾驶数字 :
.vscode/mcp.json - 光标 IDE数字 :
.cursor/mcp.json
需要零手动JSON配置.
2. 手工客户端配置
配置其他客户端( 如 Claude D桌面) 或添加 @aisdlc/mcp 手动 :
{
"mcpServers": {
"ai-sdlc": {
"command": "npx",
"args": ["-y", "@aisdlc/mcp"]
}
}
}
可用的 MCP 工具
@aisdlc/mcp 提供24种确定性工具,分为4个功能类别:
1. 工作流程和脚手架工具(综合入口)
| 工具 | 说明 | 参数 |
|---|---|---|
new | 初始化新项目或配置AI-SDLC在现有寄存器(政策、模板、钩子和可选的CI)中的治理和结构. | targetDir (弦声), (中文(简体) ), ci (enum: gi, gi,取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取, (中文(简体) ), dryRun (布尔), (中文(简体) ), agents (弦声), (中文(简体) ), architecture (enum:最小,完整,完整,无) |
verify | 执行确定性AI-SDLC 质量门(所有12个门都在 full 剖面图,或 lite 在综合运行中,并返回总体储存库健康. | root (弦声), (中文(简体) ), profile (单位:满,升) |
report | 生成所有AI-SDLC报告合并:带有PDAC图(HTML)的交互式网络仪表板和正式代码质量报告(Markdown). | root (弦声), (中文(简体) ), dashboardOutput (弦声), (中文(简体) ), qualityPolicy (弦声) |
2. Spec-Driven开发工具
| 工具 | 说明 | 参数 |
|---|---|---|
sdd_change_new | 创建全定型脚手架,用于新的 SDD 变化(proposal.md, (中文(简体) ), spec.md, (中文(简体) ), design.md, (中文(简体) ), tasks.md, (中文(简体) ), handoff.yaml) (中文(简体) ). | name (字符串,需要), (中文(简体) ), id (弦声), (中文(简体) ), profile (enum:补丁,标准,临界), (中文(简体) ), framework (enum:开光,分光), (中文(简体) ), author (弦声), (中文(简体) ), from (弦声), (中文(简体) ), root (弦声) |
sdd_check_fix | 最终将 Gherkin 情景同步到 .feature 文档,并更新PDAC SHA-256文摘,不触取源代码. | root (弦声) |
sdd_deposit | 储存或再生峡谷 handoff.yaml (单位:千美元)HOF-*正在运行的 SDD 变化中的侧车. | change (字符串,需要), (中文(简体) ), title (弦声), (中文(简体) ), framework (enum:开光,分光), (中文(简体) ), requirements (弦声), (中文(简体) ), useCases (弦声), (中文(简体) ), root (弦声) |
sdd_integrate | 将已完成的SDD修改纳入犬科基线并加以推广,并将其目录存档于 completed/。 。 。 . | change (弦声), (中文(简体) ), auto (布尔), (中文(简体) ), author (弦声), (中文(简体) ), root (弦声) |
get_active_handoff | 询问元件中的 PDAC 子图和内含的主动变化,用于外科上下文注入剂. | change (字符串,需要), (中文(简体) ), root (弦声) |
3. 颗粒核查工具(质量门)
| 工具 | 说明 | 参数 |
|---|---|---|
verify_quality | 评价环形复杂性、认知复杂性、可维持性指数和函数长度与 quality-policy.yaml。 。 。 . | root (弦声), (中文(简体) ), maxCyclomatic (数目), (中文(简体) ), maxCognitive (数目), (中文(简体) ), minMaintainability (数目) |
verify_schemas | 对照Canonical JSON Schemas验证Markdown文物规格(2020-12草案). | root (弦声) |
verify_security | 执行确定性的秘密扫描(Gitleaks)和SAST静态分析(命令注射,SQLi,SSF). | root (弦声), (中文(简体) ), minSeverity (英文:Critical, High, MEDIUM) (中文(简体) ) |
verify_privacy | 个人数据资产DATA-ASSET-*), GDPR 第30条 记录PRIV-ROPA-*),隐私要求PRIV-REQ-*),DPIA出入口(DPIA-*)和静态的PII-SAST规则(PRIV-001– 说吧 –PRIV-008反对 privacy-policy.yaml。 。 。 . | root (弦声), (中文(简体) ), policyPath (弦声), (中文(简体) ), writeReports (布尔) |
verify_traceability | 审计360°倒向可追溯性矩阵(上流PDAC,中流弧42,下流BDD/测试). | root (弦声) |
verify_governance | 审计任务治理合规和人类自主分类模式(AUTONOMOUS, (中文(简体) ), HUMAN_REVIEW_PLAN(见a/c.5/49/70,附件). | root (弦声) |
verify_testing | 对100%的要求和任务在磁盘上有可核查测试的审计. | root (弦声) |
verify_licenses | 对开源许可证的遵守情况 license-policy.yaml。 。 。 . | root (弦声), (中文(简体) ), policy (弦声), (中文(简体) ), depth (enum:直接,中转) |
verify_duplicates | 审计识别碰撞,冗余规范声明,规格重叠. | root (弦声) |
verify_friction | 评估进步摩擦规则和反过道护栏(防止修饰被保护路径的补丁描述变化). | change (弦声), (中文(简体) ), diffFiles (弦声), (中文(简体) ), root (弦声) |
verify_pdac | 审计产品图表(产品定义为代码),确定是否核实引用中不存在密码漂移. | root (弦声), (中文(简体) ), autoSync (布尔) |
4. 报告和遥测工具
| 工具 | 说明 | 参数 |
|---|---|---|
report_dashboard | 生成 RTM / PDAC 矩阵的交互式网络仪表板和 Cytoscape.js 图 reports/dashboard.html。 。 。 . | output (弦声), (中文(简体) ), title (弦声), (中文(简体) ), root (弦声) |
report_quality | 在 reports/QUALITY_REPORT.md。 。 。 . | policy (弦声), (中文(简体) ), mode (enum:STRICT, PERMISSIVE) (中文(简体) ), (中文(简体) ), root (弦声) |
kpi_pr | 计算将 KPI 聚合和遥测( human vs. AI 代理) 用于拉请求 . | base (弦声), (中文(简体) ), head (弦声), (中文(简体) ), root (弦声) |
kpi_release | 计算合并释放的KPI(缺陷注射率,再工作比率,KLOC音量,符号成本等). | release (字符串,需要), (中文(简体) ), base (弦声), (中文(简体) ), outputDir (弦声), (中文(简体) ), writeReports (布尔), (中文(简体) ), root (弦声) |
git_detect_author | 通用和IDE独立检测当前作者是人还是AI代理. | root (弦声) |
可用上下文资源
MCP 服务器通过 Cononical 提供可访问的只读上下文资源 aisdlc:// URIs : (英语)
| 资源URI | MIME 类型 | 说明 |
|---|---|---|
aisdlc://policies/quality | text/yaml | 内容 quality-policy.yaml (复杂门槛,规则,出入口限制). |
aisdlc://policies/licenses | text/yaml | 内容 license-policy.yaml (许可、限制和被冻结的许可证). |
aisdlc://policies/privacy | text/yaml | 内容 privacy-policy.yaml (GDPR/LOPDGDD/ISO 27701规则,PII-SAST控制,允许区域). |
aisdlc://changes/active | application/json | 正在运行的 SDD 变化结构化列表 specs/changes/active/ 任务和交接状态. |
aisdlc://changes/completed | application/json | 已完成并存档的 SDD 更改列表 specs/changes/completed/。 。 。 . |
aisdlc://status/summary | application/json | 综合寄存器状态汇总(手提数,政策文件存在,时间戳). |
相关软件包
| 软件包 | 目的 |
|---|---|
@aisdlc/core | AI-SDLC核心能力 |
@aisdlc/mcp | MCP一体化 |
@aisdlc/cli | 命令行接口 |
AI-本土工程
AI-SDLC是按照一项重要原则设计的:
AI辅助开发应当在不去除工程控制的情况下增加工程杠杆.
MCP提供了一种集成机制,通过允许AI系统与被控制的工程能力相互作用,使得这一点成为可能.
项目
AI-SDLC是一个开源项目.
GitHub : (中文(简体) ) https://github.com/altromon/AI-SDLC 页面存档备份,存于互联网档案馆
该数据库载有完整的架构、治理模式、发展进程和文件.
捐款
欢迎发言、议题和建筑讨论.
请参看GitHub 捐款准则和发展信息库.
许可证
参见当前许可条款的存放许可证.