项目简介 Dossier MCP 服务器是 Model Context Protocol (MCP) 的一个实现,旨在为 AI 代理提供一个可靠的上下文服务框架。它允许 LLM 客户端通过标准化的方式访问和管理“Dossier”指令文件,执行自动化工作流,并确保操作的安全性和完整性。Dossier 文件本身是结构化的纯文本指令,类似于为 AI 设计的 Dockerfile,支持版本控制、校验和与签名验证。

主要功能点

  • Dossier 安全验证: 自动校验 Dossier 文件的完整性(通过 SHA256 校验和)和真实性(通过数字签名),提供执行前的安全建议(允许、警告或阻止)。
  • Dossier 内容读取: 允许 LLM 安全地读取 Dossier 文件的元数据和主体内容,以便理解并执行其中包含的指令。
  • Dossier 发现: 能够递归扫描指定目录,发现并列出所有可用的 Dossier 文件及其关键元数据,帮助 LLM 找到合适的自动化任务。
  • 协议与安全资源: 提供内置的资源,如 Dossier 执行协议和安全架构文档,为 LLM 提供关于如何安全交互和操作的上下文信息。
  • 指令模板: 提供预定义的 Prompt 模板,如“执行 Dossier”和“创建 Dossier”,帮助 LLM 以结构化方式启动常见任务。

安装步骤 Dossier MCP 服务器作为一个 npm 包提供。

  1. 安装 Node.js: 确保您的系统上安装了 Node.js(推荐 LTS 版本)。
  2. 全局安装 (可选): 如果您希望全局使用 'dossier-mcp-server' 命令,可以执行以下命令:
    npm install -g @imboard-ai/dossier-mcp
    否则,'npx' 方式将会在首次使用时自动下载和运行。

服务器配置 MCP 服务器是为 MCP 客户端(如 Claude Code)提供服务的。您需要在 MCP 客户端的配置文件中添加 Dossier MCP 服务器的启动命令。

例如,在 Claude Code 的配置文件 '~/.claude/settings.local.json' 中,添加以下配置:

{
  "mcpServers": {
    "dossier": {
      "command": "npx",
      "args": ["-y", "@imboard-ai/dossier-mcp"]
    }
  }
}
  • '"dossier"': 这是您给这个 MCP 服务器起的名称,LLM 客户端会用它来引用此服务。
  • '"command"': 启动 MCP 服务器的命令。'"npx"' 会在不全局安装的情况下运行 npm 包。
  • '"args"': 传递给启动命令的参数。'"-y"' 用于跳过 'npx' 的确认提示,'"@imboard-ai/dossier-mcp"' 是 Dossier MCP 服务器的 npm 包名。

如果您已全局安装了 Dossier MCP 服务器:

{
  "mcpServers": {
    "dossier": {
      "command": "dossier-mcp-server"
    }
  }
}
  • '"command"': 直接使用全局安装后提供的可执行命令 'dossier-mcp-server'。

配置完成后,请重启您的 MCP 客户端(如 Claude Code),以加载新的 MCP 服务器。

基本使用方法 配置并重启客户端后,您的 LLM 客户端将能够自动发现并使用 Dossier MCP 服务器提供的功能。

例如,您可以在 LLM 客户端中直接与 Dossier MCP 服务器进行交互:

  • 验证 Dossier: LLM 可以调用 'verify_dossier' 工具来检查 Dossier 的安全性,例如:“请验证我的项目目录中的 'deploy-to-aws.ds.md' 文件。”
  • 读取 Dossier: LLM 可以调用 'read_dossier' 工具来获取 Dossier 的详细内容,例如:“读取 'examples/development/setup-react-library.ds.md' Dossier 的元数据和主体。”
  • 列出 Dossier: LLM 可以调用 'list_dossiers' 工具来发现当前目录或指定目录下的所有 Dossier,例如:“列出我项目根目录下所有可用的 Dossier 文件。”
  • 获取协议文档: LLM 可以请求 'dossier://protocol' 资源来获取 Dossier 执行协议的详细信息。
  • 执行 Dossier 任务: 通过使用预定义的 Prompt,LLM 可以在执行 Dossier 时获得更强的指引,例如:“使用 'execute-dossier' 指令模板来运行 'deploy-to-aws.ds.md'。”

信息

分类

开发者工具