prepboard

Name: prepboard
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 prepboard

prepboard 是面向 Calaf 招聘工作区的命令行与 stdio MCP 转发客户端。它仅实现参数表已公开的 4 个种子工作流工具，不为其他已记录工具猜测参数结构。

主要功能

01读取种子文档格式
02验证种子
03将种子导入工作区
04列出工作区
05命令行与 stdio MCP 服务

适用场景

01查看预期的种子结构
02导入前验证种子
03将选定的种子部分导入工作区
04查看可用的招聘工作区

MCP 相关

其 stdio MCP 服务提供 4 个 Calaf 工具：get_seed_format、validate_seed、import_seed 和 list_workspaces。它将调用转发至公共或账户 MCP 端点；账户工具需要 CALAF_ACCESS_TOKEN。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-prepboard": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/prepboard"
      ]
    }
  }
}

启动命令npx -y @reneturcios/prepboard

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/prepboard0.1.0stdio

ocighcr.io/cloudcorprecords/prepboard:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

prepboard

prepboard 是一款小型转发客户端，适用于 Calaf 招聘工作区服务。它涵盖种子工作流：读取种子文档格式、根据该格式验证种子、将种子导入工作区，以及列出你的工作区。一个二进制文件同时提供命令行界面和 stdio MCP 服务。

标注的核心子集 — 38 个工具中的 4 个。 原始 Calaf 账户服务记录了 38 个工具，但只有其中 4 个发布了参数表。prepboard 仅构建这 4 个工具，并省略其余 34 个，而不是凭空编造它们的架构。省略的工具包括：export_seed、get_profile_schema、 get_firm_profile、submit_firm_profile、log_touchpoint、 update_contact、add_task、get_contacts、get_firms、 log_firm_work、get_firm_work、remove_firm_work、 get_applications、schedule_interview、add_application、 update_application、get_tasks、complete_task、snooze_task、 add_firm、update_firm、add_office、add_note、get_notes、 update_note、create_workspace、rename_workspace、 archive_workspace、add_template、get_templates、 update_template、add_prep_question、get_prep、 draft_prep_answer。

与 Calaf 的通信方式

调用会以 JSON-RPC tools/call POST 请求的形式转发到上游 MCP 端点——这种线路格式是根据公开规范重建并记录的，上游的 result 值会原样返回。

公共种子端点：https://calaf.ai/api/mcp — 无需身份验证。提供 seed-format / get_seed_format 和 validate-seed / validate_seed。
账户端点：https://calaf.ai/api/mcp-account — 需要 Authorization: Bearer <token>，令牌来自 CALAF_ACCESS_TOKEN 环境变量。提供 import-seed / import_seed 和 workspaces / list_workspaces。如果缺少令牌，这些命令会报错并指出 CALAF_ACCESS_TOKEN；它们绝不会伪造结果。

端点覆盖项：公共端点使用 CALAF_MCP_URL，账户端点使用 CALAF_ACCOUNT_MCP_URL。

安装

npx @reneturcios/prepboard seed-format

或者运行容器映像：

docker run -i ghcr.io/cloudcorprecords/prepboard

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。容器内的账户命令需要 -e CALAF_ACCESS_TOKEN=...。

CLI

prepboard seed-format
prepboard validate-seed '<seed-json-or-string>'
prepboard import-seed my-workspace '<seed-json-or-string>' --parts orgs,templates,prep,contacts
prepboard workspaces

prepboard --version

<seed> 参数会在解析为对象时作为 JSON 值处理，否则会作为纯字符串种子处理——Calaf 种子格式接受字符串和对象两种形式。命令会将上游结果以 JSON 格式输出。退出代码：成功时为 0，调用失败时为 1（包括缺少令牌或上游错误），用法错误时为 2。

MCP 服务

一个二进制文件提供两种用法。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/prepboard mcp

MCP 客户端配置：

{
  "mcpServers": {
    "prepboard": {
      "command": "npx",
      "args": ["-y", "@reneturcios/prepboard", "mcp"],
      "env": {
        "CALAF_ACCESS_TOKEN": "<your Calaf access token>"
      }
    }
  }
}

只有 import_seed 和 list_workspaces 需要令牌；get_seed_format 和 validate_seed 无需任何配置即可使用。

工具

工具	输入	端点	返回内容
`get_seed_format`	（无）	公共	种子文档格式。
`validate_seed`	`seed`（字符串或对象，必填）	公共	该种子的验证结果。
`import_seed`	`workspace`（必填）、`seed`（字符串或对象，必填）、`parts`（字符串数组，可选：orgs / templates / prep / contacts）	账户	导入结果。
`list_workspaces`	（无）	账户	调用者的工作区。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx