onboarding

mcp-onboarding

已收录于官方 MCP 注册表（io.github.theluckystrike/onboarding）。 为新员工提供基于角色的入职任务模板，并为每位员工创建一份带日期的清单，供 HR 和经理共同查看。

决定其他一切的一条规则

如果有人之后编辑清单， 添加或删除某个步骤，每个已经开始的流程都会保留启动时的步骤列表， 并在流程中记录它所复制的清单版本。

这并非为了方便缓存。有人勾选并签署的清单，必须与他们实际看到的清单一致。如果流程实时读取清单中的步骤，就可能出现这样的情况：签署的交接证明上有 11 项检查，而签署人实际看到的是 10 项，并且记录中没有任何字段表明发生过这种情况。这也意味着删除清单后，相关流程仍然可读且完整；一年后有人询问检查了什么时，这正是你所需要的。

由此还可得出两条较小的规则：

• 不存储任何派生数据。 已通过、未通过和未完成的计数、百分比，以及流程是否可以签署，都会在每次调用时根据流程自身的步骤计算。存储的“已完成”标记，只能说明上次查看时的情况；而这里的 complete 是一种实时状态：最后一个步骤得到答复时就会显示，某个步骤重新设为待处理时又会消失。
• 不适用不等于通过。 na 计为已答复，但绝不会计为已通过。检查后判定不适用，与检查通过是两种不同的事实；将二者合并，会导致清单在一半步骤都不适用的工作中报告满分。

哪些情况会阻止签署

必填步骤未作答、必填步骤未通过、选填步骤未作答，或流程没有任何步骤。force: true 可强制签署，例外情况仍会记录在案，并在报告的“带例外情况签署”部分列出。它们不会丢失，也不会被隐藏。

安装

一键安装（.mcpb）：从最新版本下载 checklist.mcpb，然后在 Claude Desktop 中双击： https://github.com/theluckystrike/mcp-servers/releases/latest

@theluckystrike/mcp-onboarding 的 npm 发布尚未完成，因此下面的 npx 命令目前会返回 404。请暂时从源代码构建；参见 llms-install.md。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "checklist": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-onboarding"]
    }
  }
}

Claude Code

claude mcp add checklist -- npx -y @theluckystrike/mcp-onboarding

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），使用与 Claude Desktop 相同的条目。

工具

工具	功能
checklist_create	创建可重复使用的清单：名称、类别和描述
checklist_item_add	添加步骤：文本、所属章节标题，以及是否为必填项
checklist_item_remove	移除步骤并更新版本。已开始的运行会保留该步骤
checklist_show	按章节分组显示一份清单，并可按需提供空白打印副本
checklist_list	列出所有清单及其版本、步骤数和由其创建的运行数
checklist_delete	删除清单。其运行仍可查看，因为每次运行都附有自己的副本
run_start	针对一项工作启动带日期的运行。此时会将步骤复制到运行中
run_check	将某个步骤标记为通过、失败或不适用，并记录执行人、时间和发现
run_show	显示该运行的所有步骤及其结果、计数、失败项和阻止签核的事项
run_list	按时间倒序列出运行，可按清单、状态、参考信息筛选，或仅显示有失败项的运行
run_sign_off	使用姓名和日期签核，签核后运行将被冻结
run_status	重新打开已完成的运行，或在工作未发生时放弃运行
run_report	以文本形式输出各级别的运行报告。Pro 还会将报告写入 out_path，保存为 .txt 文件
run_delete	删除运行。已签核的运行无法删除
license_status	查看此安装所属的层级以及密钥来源
license_activate	为此服务器保存 Pro 密钥

此外还有一个资源 checklist://contract，其中包含快照规则、项目状态、运行状态机、阻止签核的事项，以及此服务器的写入位置；还有一个提示词 run_the_checklist，会按顺序引导完成整项工作。

免费版与 Pro 版

	免费版	Pro 版
可保存的清单数	3	无限
清单的运行次数	无限	无限
每份清单的步骤数	最多 500	最多 500
run_show、run_list 和计数	支持	支持
以文本形式输出运行报告	支持	支持
使用 out_path 将报告写入文件	不支持	支持

限额取决于你保存的不同清单数量，而不是检查的工作数量。只要有一份交付前检查清单、一份交接表和一份待修问题清单，一家商行就可以全年使用免费版。运行次数永不设限，因为限制清单的运行次数，就等于限制清单唯一的用途。删除清单后即可腾出名额。

购买 Pro：https://mcp.zovo.one/buy/checklist（一次性付费）；或以一个价格购买所有服务器的使用权：https://mcp.zovo.one/buy/bundle

隐私

所有数据都保存在本地的 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/checklist/ 中。此服务器不会进行任何网络调用，不需要 API 密钥或账户。它唯一读取但不拥有的文件是共享业务资料，其中包含打印报告顶部显示的名称和地址；它绝不会写入该文件。

由 theluckystrike 构建。支持邮箱：[email protected]

将这些文档用作 MCP 服务

任何 MCP 客户端（Claude、Cursor、Windsurf、VS Code）都可以通过 GitMCP 直接读取此代码库的文档，无需安装：

• 文档 MCP URL：https://gitmcp.io/theluckystrike/mcp-onboarding