Job Card Template

io.github.theluckystrike由 GitHub 账号 theluckystrike 发布v0.22.6更新于 Nov 4, 2026

Open a job card, log hours and materials against it, print the card for client sign-off.

已验证STDIO仅桌面效率与工作流金融商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手创建工单卡、记录工时与材料、累计金额，并打印带客户签字栏的卡片。

可以做什么
  • 创建工单卡，填写客户、工地、工作内容、币种和计划日期，并可列出或查看卡片及其工时与合计
  • 按工人和时薪记录工时，按数量与单位成本记录材料，金额均以整数分为单位
  • 将卡片按开放、进行中、完成、已开票、已归档逐步推进，并在历史中记录日期与备注
  • 把卡片渲染为 Markdown 或自包含 HTML，带客户签字栏以便打印
  • 按日或按周汇总：涉及的卡片、每位工人的工时，以及各币种的工时与材料金额
  • 删除误建的卡片，并查询或激活免费版或 Pro 授权
适用场景
适合小型施工队或个体从业者，用助手维护类似纸质看板的工单记录：按项目登记工时和材料、查看累计金额，并生成可打印的客户签字卡。也适合希望完全离线、单机记账、不依赖账号或云服务的场景。
运行要求
作为桌面本地进程运行；清单提供 MCPB 包，README 说明 npm 包尚未发布，目前需克隆并自行构建。数据保存在本机用户数据目录。无需账号、API 密钥或网络访问；可选的 Pro 授权密钥通过环境变量 MCP_LICENSE_KEY 提供，并离线校验。
安装前请注意
服务器会在本机写入、修改和删除工单记录，误操作会影响已保存的数据；含工时或材料的卡片不允许删除。Pro 用于解除十张活跃卡片的限制，为一次性付费购买，但密钥可选且离线校验。金额以整数分存储且不做币种换算，多币种合计彼此独立。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Job Card Template，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-job-card

[theluckystrike/mcp-job-card MCP server]

In the official MCP Registry (io.github.theluckystrike/job-card). One card per job, the way the paper one on the dashboard works. Open a card for the client and the site, log the hours each worker puts in at their rate and the materials that go into the job, and the card keeps the running totals: labor, materials and the grand total, always in integer cents. Move the card along as the job moves, open, in progress, done, invoiced, archived, and when the client wants to see it, print the card with its signature line for sign-off. A daily or weekly summary answers where the crew's hours went and what the work is worth, per currency. Everything stays on this machine; there is no account and no network call.

Built by theluckystrike.

npm publish for @theluckystrike/mcp-job-card is pending, so npx -y @theluckystrike/mcp-job-card returns 404 today. Until then, a clone+build is the working path.

Install

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

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

Claude Code

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

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project), same entry as Claude Desktop.

Tools

toolwhat it does
job_card_createOpen a job card: client, site, what the job is, currency, scheduled date. Returns JC-YYYY-NNNN
job_card_log_laborLog hours on a job card: who did the work, the day, the hours, the hourly rate in cents, what was done
job_card_log_materialLog materials used on a job card: the item, the quantity, the unit cost in cents
job_card_update_statusMove the card exactly one step -- open, in_progress, done, invoiced, archived -- stamping date and note into its history
job_card_listList cards newest first with hours and totals; filter by status and client; totals kept per currency
job_card_getRead one card in full: every entry, hours per worker, and the running totals in integer cents
job_card_printRender the card ready to print, with a signature line for client sign-off. Markdown or self-contained HTML
job_card_deleteDelete a card entered by mistake. One holding labor or materials is refused; archive it instead
job_card_summaryA day or a week: cards touched, hours per worker, labor and materials value per currency. A week runs Monday to Sunday
license_status / license_activateFree or Pro, and the key

Free vs Pro

FreePro
Active job cards10Unlimited
Labor and material entries per cardUnlimitedUnlimited
Running totals, list and getYesYes
Printable card, markdown and HTMLYesYes
Daily and weekly summaryYesYes

The record is never metered. Ten active cards is a real working board for a small crew, and a card stops counting the moment it is archived, so logging, totals, printing and summaries stay free for good. What Pro lifts is how many jobs are on the board at once.

Get Pro: https://mcp.zovo.one/buy/job-card, $19 one-time for this server, or $39 for the bundle.

Money and rounding

Every amount is an integer number of cents (a cent is 1/100 of the currency unit). A labor line is hours times the hourly rate; a materials line is quantity times the unit cost; each line value is rounded half-up to the nearest cent once, at the moment it is logged, and stored on the entry. Totals are the sums of those stored line values, so a total can never drift from its lines. Hours are carried as integer hundredths and quantities as integer thousandths, so 2.5 hours at 4999 cents an hour is 12498 cents, never 12497.499999. Currencies are never added together: this server holds no exchange rate.

Privacy

All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/job-card/. Two files: cards.json, counter.json. Nothing is sent anywhere, there is no account, no API key and no network call in this server at all. License keys are verified offline.

Built by theluckystrike. https://github.com/theluckystrike

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:

来源：servers/job-card/README.md，提交 1bd9d69

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

3
  1. v0.22.6最新Oct 14, 2026
  2. v0.22.0Oct 12, 2026
  3. v0.21.0Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分