@ai-dossier/mcp-服务器
使用一种便携式AI代理技能,跨越克洛德代码,Codex,OpenCode,以及MCP相容的工作流程.
@ai-dossier/mcp-server 用于希望其MCP客户端发现、核实和通过 示范背景协议. Dossiers是可移植的,签名的,版本化的技能:克劳德代码用户熟悉,但任何相容的LLM工具都有可核查和注册支持.
Ai-dossier生态系统的一部分: 使用
@ai-dossier/cli编写和安装技能,@ai-dossier/core核查,以及 ai- dossier 项目 为完整的平台.
安装
Claude 代码插件( 建议)
/plugin marketplace add imboard-ai/ai-dossier
/plugin install dossier-mcp-server@ai-dossier
一次性设置——包括自动更新.
Claude 代码( 手册)
# 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数字 :
{
"mcpServers": {
"dossier": {
"command": "npx",
"args": ["-y", "@ai-dossier/mcp-server"]
}
}
}
校验
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
发展
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
为大赦国际代理
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。 。 。 .