# @ai-dossier/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40ai-dossier/mcp-server/

版本：1\.6\.6
npm 元数据更新时间：2026-11-11T12:14:32.279Z
中文译文更新时间：2026-11-11T12:15:40.154Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40ai-dossier/mcp-server
原文对照：https://npmcn.com/package/%40ai-dossier/mcp-server/?lang=original
项目主页：https://ai-dossier.dev/
源码仓库：https://github.com/imboard-ai/ai-dossier

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

- 包体积（解压后）：249 kB，115 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.23\.4
- 运行依赖：3 个
- 首次发布：2026-03-05T08:15:59.113Z
- 最新版本发布：2026-11-11T12:14:31.810Z
- 近 30 天下载量：18797（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：251（近 12 个月 251 个）

## 中文简介

用于签名,版本代理技能的MCP服务器:通过"模型上下文协议"来发现,验证,并运行模型驱动管弦乐的技能.

## 安装

```sh
npm install @ai-dossier/mcp-server
```

也可以使用：`pnpm add @ai-dossier/mcp-server`、`yarn add @ai-dossier/mcp-server`、`bun add @ai-dossier/mcp-server`

## README

# @ai-dossier/mcp-服务器

[![npm version](https://img.shields.io/npm/v/@ai-dossier/mcp-server)](https://www.npmjs.com/package/@ai-dossier/mcp-server) [![npm downloads](https://img.shields.io/npm/dm/@ai-dossier/mcp-server)](https://www.npmjs.com/package/@ai-dossier/mcp-server) [![npm provenance](https://img.shields.io/badge/npm-provenance%20%28SLSA%29-brightgreen?logo=npm)](https://www.npmjs.com/package/@ai-dossier/mcp-server#provenance) [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://github.com/imboard-ai/ai-dossier/blob/main/LICENSE)

**使用一种便携式AI代理技能,跨越克洛德代码,Codex,OpenCode,以及MCP相容的工作流程.**

`@ai-dossier/mcp-server` 用于希望其MCP客户端发现、核实和通过 [示范背景协议](https://modelcontextprotocol.io/). Dossiers是可移植的,签名的,版本化的技能:克劳德代码用户熟悉,但任何相容的LLM工具都有可核查和注册支持.

> **Ai-dossier生态系统的一部分**: 使用 [`@ai-dossier/cli`](https://npmcn.com/package/%40ai-dossier/cli/README.md) 编写和安装技能, [`@ai-dossier/core`](https://npmcn.com/package/%40ai-dossier/packages/core/README.md) 核查,以及 [ai- dossier 项目](https://github.com/imboard-ai/ai-dossier) 为完整的平台.

## 安装

### Claude 代码插件( 建议)

```
/plugin marketplace add imboard-ai/ai-dossier
/plugin install dossier-mcp-server@ai-dossier
```

一次性设置——包括自动更新.

### Claude 代码( 手册)

```bash
# Global (available across all projects)
claude mcp add dossier --scope user -- npx @ai-dossier/mcp-server

# Project-only
claude mcp add dossier -- npx @ai-dossier/mcp-server
```

### 克劳德桌面

添加为 `claude_desktop_config.json`数字 :

```json
{
  "mcpServers": {
    "dossier": {
      "command": "npx",
      "args": ["-y", "@ai-dossier/mcp-server"]
    }
  }
}
```

### 校验

```bash
claude mcp list
```

那就试试:

```
"List available dossiers in this project"
"Execute the project-init dossier"
```

* * *

## 工具

### 发现并读取

| 工具 | 说明 |
| --- | --- |
| `list_dossiers` | 在目录中发现可用的档案。 扫描 `*.ds.md` 文档并返回元数据. |
| `read_dossier` | 阅读并分析一个档案文件。 返回元数据和内容。 以后应该叫 `verify_dossier` 通过。 过 `dry_run: true` 获取 `dry_run_plan` (静态预览). |
| `search_dossiers` | 以关键词和可选类别过滤器搜索现有档案材料的档案登记册. |

### 安全核查

| 工具 | 说明 |
| --- | --- |
| `verify_dossier` | 核查单一档案的完整性(核对)和真实性(签名)。 返回/没有舞台细节. |
| `verify_graph` | 批次在解析的依赖图中验证所有文件. 返回安全报告总和,按剂量分列. |

### 管弦乐团(多相路由)

| 工具 | 说明 |
| --- | --- |
| `resolve_graph` | 将档案依赖性图表纳入执行计划。 生产一个DAG,有命令的相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相. |
| `start_journey` | 从已解析和已核实的图表开始行程会话 。 返回第一步的上下文的档案内容。 与 `dry_run: true` 没有创建会话,而是返回静态的每步预览(文件、命令、网络、env、风险分数)。 预览取自已声明的元数据和代码块;执行代理可能采取其他动作,得分为heuristic,不是安全保障. |
| `step_complete` | 将当前行程步骤标为完整或失败 。 与以往产出相关联的下一步进展. |
| `get_journey_status` | 获得目前行程状态:完成步骤,当前步骤,剩余步骤,并收集产出. |
| `cancel_journey` | 取消活动行程会话 。 返回取消前完成的内容摘要. |

* * *

## 资源

| URI 资源 | 说明 |
| --- | --- |
| `dossier://concept` | 档案简介——它们是什么以及为什么使用它们 |
| `dossier://protocol` | 如何安全和有效地执行档案 |
| `dossier://security` | 安全模式、签署、核查和信任管理 |
| `dossier://orchestration` | 多功能旅行工具的完整参考 |

* * *

## 提示

| 提示 | 说明 |
| --- | --- |
| `execute-dossier` | 查查核查和协议的档案 根据关系自动选择单相或多相多相流. |
| `execute-journey` | 通过一个多步骤的档案旅程提供指导:决心、核实、提出计划、执行步骤、收集产出. |
| `create-dossier` | 用正式的元多相模板编写新档案. |

* * *

## 警卫

在运行前,每个档案的执行都经过核实:

```
User: "Execute the deploy-to-aws dossier"

LLM:  *Calls verify_dossier*

      Security Verification:
      - Integrity: Checksum verified (content not tampered with)
      - Authenticity: Signed by imboard-ai-2024 (trusted)
      - Risk Level: HIGH

      This dossier will modify AWS infrastructure.
      Proceed? (y/N)
```

### 核查结果

-   **允许** ——来自可信来源的验证签名+低风险. 自信地执行.
-   **战争** ——未署名/未知签名者或高风险. 请求用户批准.
-   **块** — 校验和失败或签名无效 。 不执行 .

### 特征

-   **诚信**: SHA256核对和确保档案没有被修改
-   **签署**: 可选的 Ed25519 或 AWS KMS 密码签名( 遗留的小符号密钥仍在验证)
-   **风险评估**: 申报的风险水平和每个档案的具体风险因素
-   **信任模式**: 分散式——用户选择哪个签名密钥通过 `~/.dossier/trusted-keys.txt`

* * *

## 发展

```bash
git clone https://github.com/imboard-ai/ai-dossier.git
cd ai-dossier/mcp-server
npm install
npm run build
npm test
npm start
```

### 项目结构

```
mcp-server/
  src/
    index.ts                 # Server entry point
    tools/                   # Tool implementations
    resources/               # Resource providers
    orchestration/           # Graph resolution, sessions, output mapping
    utils/                   # Logger, CLI wrapper, response helpers
```

* * *

## 技术细节

-   **议定书**: MCP(模式背景议定书)
-   **语言**: 类型脚本
-   **运行时间**:节点.js 20+
-   **运输**: stdio (中文(简体) )
-   **依赖关系**数字 : `@modelcontextprotocol/sdk`, (中文(简体) ), `@ai-dossier/core`
-   **许可证**页:1

* * *

## 为大赦国际代理

```bash
npm run build -w mcp-server    # build (requires core built first)
npm run test -w mcp-server     # test
make build-mcp                 # build core + mcp-server together
```

-   `src/index.ts` ——服务器条目:登记所有工具、资源和提示
-   `src/tools/` ——每个MCP工具一个文件(例如. `verifyDossier.ts`(中文(简体) )
-   `src/resources/` 固定的MCP资源(概念、协议、安全、协调)
-   `src/orchestration/` ——图解和行程会话管理
-   `src/utils/` - 记录器、CLI包装器、反应辅助器

**添加工具时 :** 创建 `src/tools/myTool.ts`,导出处理器+输入类型,登记在 `src/index.ts` (添加到 ListTools + CallTools 开关).

**正在添加资源 :** 创建 `src/resources/myResource.ts`,注册到 `src/index.ts` (添加到列表资源+读取资源开关).

**档案用户(非撰稿人):** 通过 `claude mcp add dossier -- npx @ai-dossier/mcp-server` 获取 `dossier://` 运行时的资源和工具。 MCP 磁共振 登记名称: `ai.imboard/dossier`。 。 。 .

* * *

## 链接

-   [规格](https://npmcn.com/package/%40ai-dossier/mcp-server/SPECIFICATION.md)
-   [更改日志](https://npmcn.com/package/%40ai-dossier/mcp-server/CHANGELOG.md)
-   [剂量标准](https://npmcn.com/package/%40ai-dossier/README.md)
-   [实例](https://npmcn.com/package/%40ai-dossier/examples/)

## 常见问题

### @ai-dossier/mcp-server 是什么？

用于签名,版本代理技能的MCP服务器:通过"模型上下文协议"来发现,验证,并运行模型驱动管弦乐的技能\.

### 如何安装 @ai-dossier/mcp-server？

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

### @ai-dossier/mcp-server 支持 TypeScript 吗？

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

### @ai-dossier/mcp-server 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @ai-dossier/mcp-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.23\.4。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ai-dossier/mcp-server 可以商用吗？

@ai-dossier/mcp-server 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-dossier/mcp-server 的下载量有多少？

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

### @ai-dossier/mcp-server 还在维护吗？

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