McpStamp Work Orders

io.github.theluckystrike由 GitHub 帳號 theluckystrike 發布v0.23.0更新於 Nov 3, 2026

現場作業工單:零件與人工、狀態步驟、完工報告、發票明細行。

AI 翻譯由 AI 模型根據下方的原文描述翻譯,可能有誤。

原文描述

Work orders for site jobs: parts and labour, status steps, completion reports, invoice lines.

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

McpStamp Work Orders 的託管 MCP 服務(mcp.zovo.one);無需登入;Streamable HTTP;12 個工具。

暫無 AI 概覽:以下資訊來自註冊中心條目和服務本身。

端點
mcp.zovo.one
最近檢查

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 McpStamp Work Orders,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.theluckystrike%2Fwork-order/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mcpstamp-work-orders": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/work-order"
    }
  }
}

README

mcp-work-order

In the official MCP Registry (io.github.theluckystrike/work-order). Job orders for trades and field work, kept the way a job card is kept. Raise a work order against a client (the same client record your invoices use), give it a site address, the date it was asked for, what the job is and how urgent. Log what the job actually used as it goes: labour as hours at a rate, parts as a quantity at a unit cost with an optional markup. Move it along one step at a time, draft to scheduled to in progress to done to invoiced, each step stamped with its date and a note. When it is finished, hand the customer a completion report with the hours, the materials, the totals and a sign-off block, and take the invoice payload straight to invoice_create without retyping a single figure.

Nothing is invented and nothing is stored twice: the value, the hours, the materials and the VAT are derived from the lines on every call, and the invoice payload's unit prices are already the billed units, so the invoice reproduces the work order to the minor unit.

npm publish for @theluckystrike/mcp-work-order is pending, so npx -y @theluckystrike/mcp-work-order returns 404 today. Until then, the .mcpb one-click bundle or a clone+build is the working path.

Install

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Claude Code

sh
claude mcp add work-order -- npx -y @theluckystrike/mcp-work-order

Cursor

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

Tools

ToolWhat it does
work_order_createRaise a job order and return its WO-YYYY-NNNN number: client, site address, requested date, description, priority
work_order_add_lineAdd one line: parts with a quantity and a unit cost in minor units and an optional markup percent, or labour with hours and an hourly rate
work_order_statusMove it one step: draft, scheduled, in_progress, done, invoiced, stamping the date and a note
work_order_getOne work order in full: every line with its billed unit, the hours, the materials, net and VAT, and the status history
work_order_listList work orders by status, by client and by requested-date range
work_order_deleteDelete a work order raised by mistake. Draft with no lines only. Free on every tier
completion_report_textThe completion report as plain text, ready to paste into an email
completion_report_pdfThe completion report as an A4 PDF, with the sign-off block
work_order_invoice_payloadAn invoice_create-ready payload from the lines, with VAT at the shared profile rate
work_orders_reportThe whole board: work orders per status, hours logged this month, unbilled value per currency
license_status / license_activateFree or Pro, and where to upgrade

Free vs Pro

FreePro
Open work orders5unlimited
Lines per work order200200
Raise, log, move, list, deleteyesyes
Completion report (text)yesyes
Completion report (PDF)noyes
Invoice payloadnoyes
Board reportnoyes

The cap counts OPEN work orders (draft, scheduled, in progress), not the ones you have ever raised, so finishing a job frees its slot. So does work_order_delete on a draft that has no lines, which is free on every tier: a way back that only a Pro key can reach is not a way back.

Get Pro: https://mcp.zovo.one/buy/work-order (one-time $19, lifetime), or all servers for $39: https://mcp.zovo.one/buy/bundle

Where the money comes from

This server keeps no arithmetic of its own. computeTotals, currencyDecimals, formatMoney and roundHalfUp are imported from @theluckystrike/mcp-invoice/lib, the A4 renderer from @theluckystrike/mcp-billing-docs/lib, the corrupt-store quarantine from @theluckystrike/mcp-timezone/lib. The VAT rate, the currency and the business name come from the shared business profile that business_set in the invoice server writes; the client comes from that server's client records. Nothing is written outside this server's own directory.

The measured insight

A markup belongs on the unit cost, not on the line total, and one minor unit is what says so. Seven parts at EUR 12.99 with 15 percent on top is EUR 14.94 a unit and EUR 104.58 on the line. Marking up the line total instead is round(9093 * 1.15) = 10,457 minor units, a cent less. Both look like the same sum, and only one of them is the figure the customer will be billed: the invoice server rounds the unit price to the minor unit first and multiplies (its D-R24 basis), so a work order that quotes the line-total figure quotes a number its own invoice cannot reproduce. The gap appears on every line whose marked-up unit does not land on a whole cent, it never nets out across lines because it is a rounding direction and not an error, and it is invisible in a spreadsheet check because both bases add up correctly. The unit suite asserts the 1-unit gap explicitly, so a change of basis fails the build instead of quietly re-pricing every job on the board.

Privacy

All data stays on your machine, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/work-order/. Nothing is sent anywhere. There is no account and no API key. License keys are verified offline. This server reads one sibling file, the invoice server's clients.json, and writes into no store but its own.

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/work-order/README.md,提交 6535b33

工具

12

work_order_create

Raise a work order

Raise a job order and return its WO-YYYY-NNNN number: the client, the site address, the date it was asked for, what the job is and how urgent. Free tier: 5 open orders.

輸入參數noteclient必填currencyprioritydescription必填client_emailduplicate_oksite_address必填client_vat_idclient_addressrequested_date必填

work_order_add_line

Add a parts or labour line

Add one line: parts with quantity, unit_cost_minor in whole MINOR units and optional markup, or labour with hours and rate_minor. A line on an invoiced order, or dated before the request, is refused.

輸入參數datekind必填notehoursquantityrate_minorwork_order必填description必填markup_percentunit_cost_minor

work_order_status

Move a work order along

Move one work order exactly one step: draft, scheduled, in_progress, done, invoiced, stamping date and note. A skipped, backwards or backdated step is refused and nothing is written. Free.

輸入參數datenotestatus必填work_order必填

work_order_get

Show one work order

Return one work order in full by WO number or client: the site, every parts and labour line with the unit billed, hours, materials, net and VAT, and the status history. Reads only. Free.

輸入參數work_order必填

work_order_list

List work orders

List work orders newest requested first: status, priority, client, site, hours, labour, materials and net value, with totals per currency. Filter by status, client and requested-date range. Free.

輸入參數tofromlimitclientstatus

work_order_delete

Delete a draft work order

Delete a DRAFT work order with no lines, freeing an open slot. One past draft is refused, naming the date it got there, and so is one carrying lines. The WO number is never reissued. work_order_status moves it on.

輸入參數work_order必填

completion_report_text

Completion report as plain text

Turn a work order into a plain-text completion report: what was done, the labour hours, the materials, the totals and a sign-off block, ready to paste into an email. The same text also comes back as a .txt download link valid for one hour. Free on every tier.

輸入參數work_order必填

completion_report_pdf

Completion report as a PDF

Call this tool to render the A4 completion report of one work order and return a download link valid for one hour: the lines, the hours, the materials, the totals and the sign-off block. Pro.

輸入參數out_pathwork_order必填

work_order_invoice_payload

Invoice payload for a work order

Build an invoice_create-ready payload from the lines, with VAT at the shared profile rate. Writes nothing and marks nothing: raise the invoice in the invoice server, then set this order invoiced. Pro.

輸入參數tax_rateissue_datework_order必填

work_orders_report

Report the board

Report the whole board: how many work orders sit at each status, the hours logged this month, and the value not yet invoiced per currency, with the oldest open jobs named. Pro.

輸入參數limitmonth

license_status

License status

Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

無需輸入參數。

license_activate

Activate license

Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

輸入參數key必填

版本歷史

5
  1. v0.23.0最新Nov 3, 2026
  2. v0.22.6Oct 14, 2026
  3. v0.22.1Oct 9, 2026
  4. v0.22.0Sep 17, 2026
  5. v0.21.0Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分