job-card

mcp-job-card

位于官方 MCP Registry（io.github.theluckystrike/job-card）。 每项工作一张工作卡，就像看板上的纸质卡片一样。为客户和现场创建一张卡片，记录每位工作人员按其费率投入的工时以及工作所用的材料，卡片会持续汇总人工费、材料费和总计，始终以整数美分计。随着工作进展更新卡片状态：open、in progress、done、invoiced、archived；客户想查看时，可打印带签名栏的卡片以供签字确认。每日或每周摘要会按货币列出团队工时的去向及工作价值。所有内容都保存在这台机器上；无需账户，也不会发起网络请求。

由 theluckystrike 构建。

@theluckystrike/mcp-job-card 尚未发布到 npm，因此目前运行 npx -y @theluckystrike/mcp-job-card 会返回 404。在此之前，克隆并构建是可用的方式。

安装

Claude Desktop

macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json：

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

Claude Code

claude mcp add job-card -- npx -y @theluckystrike/mcp-job-card

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），配置项与 Claude Desktop 相同。

工具

工具	功能
job_card_create	创建工作卡：客户、现场、工作内容、货币和计划日期。返回 JC-YYYY-NNNN
job_card_log_labor	在工作卡上记录工时：工作者、日期、工时、以美分计的时薪，以及完成的工作
job_card_log_material	在工作卡上记录所用材料：物品、数量和以美分计的单位成本
job_card_update_status	将卡片状态准确推进一步——open、in_progress、done、invoiced、archived——并将日期和备注记录到历史中
job_card_list	按最新优先列出卡片及工时和总计；可按状态和客户筛选；总计按货币分别计算
job_card_get	完整读取一张卡片：所有条目、每位工作者的工时，以及以整数美分计的累计总额
job_card_print	渲染可直接打印的卡片，并附有供客户签字确认的签名栏。支持 Markdown 或独立 HTML
job_card_delete	删除误建的卡片。若卡片已有人工费或材料记录，则拒绝删除；请改为归档
job_card_summary	按日或按周汇总：有更新的卡片、每位工作者的工时，以及按货币计算的人工费和材料价值。一周从周一到周日
license_status / license_activate	查询 Free 或 Pro 状态，以及许可证密钥

Free 与 Pro

	Free	Pro
活跃工作卡	10	不限
每张卡片的人工费和材料条目	不限	不限
累计总额、列表和详情	支持	支持
可打印卡片，支持 Markdown 和 HTML	支持	支持
每日和每周摘要	支持	支持

记录数量从不受限。10 张活跃卡片足以作为小团队的实际工作看板；卡片一经归档便不再计入数量，因此记录、汇总、打印和摘要始终免费。Pro 提升的是看板上可同时容纳的工作数量。

获取 Pro：https://mcp.zovo.one/buy/job-card，此服务一次性付费 $19，或购买组合包，价格为 $39。

金额与舍入

每笔金额都以整数分表示（1 分是货币单位的 1/100）。人工项目的金额为工时乘以小时费率；材料项目的金额为数量乘以单位成本。每项金额在记录时只舍入一次，按四舍五入取到最接近的分，并存储在条目中。总额是这些已存储项目金额的合计，因此总额始终与各项目金额一致。工时以整数百分之一小时存储，数量以整数千分之一存储，因此，2.5 小时按每小时 4999 分计算，结果是 12498 分，不会是 12497.499999。不同货币不会相加：此服务不保存汇率。

隐私

所有数据都保存在本地的 ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/job-card/ 中。共有两个文件：cards.json、counter.json。不会向任何地方发送数据；此服务没有账户、API 密钥，也不会进行任何网络调用。许可证密钥会离线验证。

由 theluckystrike 构建。https://github.com/theluckystrike

将这些文档用作 MCP 服务

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

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