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 分