# @aisdlc/mcp 中文文档

规范地址：https://npmcn.com/package/%40aisdlc/mcp/

版本：3\.2\.0
npm 元数据更新时间：2026-11-04T18:26:00.088Z
中文译文更新时间：2026-11-06T06:48:33.463Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aisdlc/mcp
原文对照：https://npmcn.com/package/%40aisdlc/mcp/?lang=original
项目主页：https://github.com/altromon/AI-SDLC#readme
源码仓库：https://github.com/altromon/AI-SDLC

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：115 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-10-02T09:55:24.837Z
- 最新版本发布：2026-11-04T18:25:59.760Z
- 近 30 天下载量：4359（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

用于 AI-SDLC 工具、资源和治理的模拟背景协议(MCP)本地服务器

## 安装

```sh
npm install @aisdlc/mcp
```

也可以使用：`pnpm add @aisdlc/mcp`、`yarn add @aisdlc/mcp`、`bun add @aisdlc/mcp`

## README

# @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客户端与软件工程能力之间的集成机制.

## 安装

```bash
npm install @aisdlc/mcp
```

或与平按:

```bash
pnpm add @aisdlc/mcp
```

## 在AI-SDLC中的作用

该套件位于AI客户端和AI-SDLC核心之间:

```text
              AI client
                  │
                  │ MCP
                  ▼
            @aisdlc/mcp
                  │
                  ▼
            @aisdlc/core
                  │
                  ▼
        AI-SDLC engineering
           capabilities
```

这种分离保持了MCP整合与基础核心能力的独立.

## 使用量

MCP包意在将AI-SDLC能力与MCP兼容的AI客户端或代理环境相融合时被使用.

关于命令行入口和本地AI-SDLC工作流程,参见 [`@aisdlc/cli`](https://www.npmjs.com/package/@aisdlc/cli)。 。 。 .

### 运行服务器

启动 MCP 服务器 `npx` 或通过AI-SDLC CLI:

```bash
# 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` 手动 :

```json
{
  "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`](https://www.npmjs.com/package/@aisdlc/core) | AI-SDLC核心能力 |
| [`@aisdlc/mcp`](https://www.npmjs.com/package/@aisdlc/mcp) | MCP一体化 |
| [`@aisdlc/cli`](https://www.npmjs.com/package/@aisdlc/cli) | 命令行接口 |

## AI-本土工程

AI-SDLC是按照一项重要原则设计的:

> AI辅助开发应当在不去除工程控制的情况下增加工程杠杆.

MCP提供了一种集成机制,通过允许AI系统与被控制的工程能力相互作用,使得这一点成为可能.

## 项目

AI-SDLC是一个开源项目.

**GitHub : (中文(简体) )** [https://github.com/altromon/AI-SDLC 页面存档备份,存于互联网档案馆](https://github.com/altromon/AI-SDLC)

该数据库载有完整的架构、治理模式、发展进程和文件.

## 捐款

欢迎发言、议题和建筑讨论.

请参看GitHub 捐款准则和发展信息库.

## 许可证

参见当前许可条款的存放许可证.

## 常见问题

### @aisdlc/mcp 是什么？

用于 AI-SDLC 工具、资源和治理的模拟背景协议\(MCP\)本地服务器

### 如何安装 @aisdlc/mcp？

在项目目录运行 npm install @aisdlc/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aisdlc-mcp，可以用 npx aisdlc-mcp 直接运行。

### @aisdlc/mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aisdlc/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aisdlc/mcp 可以商用吗？

@aisdlc/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aisdlc/mcp 的下载量有多少？

根据 npm 官方下载统计，@aisdlc/mcp 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,359 次，日均约 145 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aisdlc/mcp 还在维护吗？

最新版本 3\.2\.0 发布于 2026/11/05（1 天前）；至今共发布 30 个版本，其中过去 12 个月发布了 30 个；首次发布于 2026/10/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。