io.github.theluckystrike由 GitHub 帳號 theluckystrike 發布v0.23.0更新於 Nov 3, 2026
跟蹤客戶保證金和預付款押金：保留、抵扣發票、退款、對帳單。
AI 翻譯由 AI 模型根據下方的原文描述翻譯，可能有誤。
Track client security and retainer deposits: hold, apply to an invoice, refund, statements.
McpStamp Deposits 的託管 MCP 服務（mcp.zovo.one）；無需登入；Streamable HTTP；11 個工具。
暫無 AI 概覽：以下資訊來自註冊中心條目和服務本身。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.theluckystrike%2Fdeposits/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"mcpstamp-deposits": {
"type": "http",
"url": "https://mcp.zovo.one/mcp/deposits"
}
}
}Security and retainer deposits, held per client, on the same engine as your invoices.
A deposit is the client's money sitting on your account. It has to be recorded when it arrives, set
against an invoice when the work is billed, given back when it is not, and answered for at any point
in between: how much of theirs are you holding, in which currency, since when. This server does
those four things, against the invoices and the clients the mcp-invoice server already holds. When
a deposit is applied to an invoice, the payment is recorded on that invoice, so invoice_list and
overdue_report stop chasing money you already have. Everything stays on your machine.
Built on @theluckystrike/mcp-invoice/lib for the money, currency and store code, and on
@theluckystrike/mcp-billing-docs/lib for the A4 page, so a deposit statement looks like the credit
note and the invoice next to it and agrees with them to the minor unit.
In the official MCP Registry (io.github.theluckystrike/deposits).
npm publish for @theluckystrike/mcp-deposits is pending, so npx -y @theluckystrike/mcp-deposits returns 404 today. Until then, the .mcpb one-click bundle or a clone+build is the working path.
Claude Desktop (claude_desktop_config.json):
Claude Code:
Cursor (.cursor/mcp.json):
Run mcp-invoice alongside it: this server reads that server's invoices and clients, writes the
payment an applied deposit makes onto the invoice, and both take their name, address, VAT id and
default currency from one shared business profile.
One resource, deposits://held, and one prompt, settle_deposits.
The free cap is on recording new deposits only. Money already held can always be applied, refunded and accounted for, on any tier: a limit that trapped a client's deposit would be a limit on their money, not on yours.
The cap counts the deposits stored with a received date in that month, so deposit_delete gives the
slot straight back: a deposit typed in twice or with the wrong amount costs nothing but the id.
deposit_record also refuses a deposit that matches one already stored on client, amount, currency,
kind, received date and reference, names that id and stores nothing, so the same money is never held
twice and no free slot is spent on a retry.
Get Pro: https://mcp.zovo.one/buy/deposits ($19 one-time for this server, $39 for the bundle).
The invoice server's own payment tool SETS the amount paid, so routing a deposit through it erases
the payment that came before. Measured against servers/invoice/dist/index.js on a EUR 1,000.00
invoice: invoice_mark_paid {amount: 200} for a bank transfer, then invoice_mark_paid {amount: 300} for the deposit, leaves paid_minor at 30000 and the reply reads "balance due EUR 700.00". The
EUR 200.00 that actually arrived is gone from the record, and the client gets chased for it.
deposit_apply writes the same three fields on the same record, paid_minor, paid_date,
status, but ADDS: the same two payments leave paid_minor at 50000 and a balance due of EUR
500.00. Asserted in test/unit.test.mjs, "a second application ADDS to paid_minor, it does not
replace it".
The general form: a store shared between two servers is safe to write only if you have read how the owning server writes it. The field names matching is not the contract; the arithmetic on them is.
All data stays local: ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/deposits/. No account, no API
key, no network call, ever. Licence keys are verified offline.
Built by theluckystrike. Support: [email protected]
Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP - no install:
來源：servers/deposits/README.md，提交 6535b33
Record a deposit received
Record a security or retainer deposit received from a client, in minor units, with its currency, the date it arrived and the bank reference. Returns the DEP-YYYY-NNNN id.
kind必填notesclient必填currencyreferenceamount_minor必填client_emailclient_vat_idreceived_dateclient_addressList deposits
List deposits newest first: DEP number, client, kind, date, reference and what was received, applied, refunded and still held, with the same four totalled per currency. Filter by client, status, kind, date.
tofromkindclientstatusApply a deposit to an invoice
Apply part of a held deposit to one invoice: it records that amount as a PAYMENT through the invoice server. amount_minor defaults to the lesser of held and owed. More than either, or a pre-arrival date, is refused.
id必填datenoteinvoice必填amount_minorRefund a deposit
Give part or all of a held deposit back to the client, with the date and how it was sent. Refuses more than is still held. The invoice server is not touched: a refund is not a payment.
id必填datenotemethodamount_minorDelete a deposit recorded by mistake
Delete a deposit that never moved money, freeing that month's free-tier slot. One with anything applied or refunded is refused, naming it, since a payment or refund would be left with nothing behind it.
id必填What is held for a client
Answer "how much of theirs am I holding?" for one client or everyone: received, applied to invoices, refunded and still held, one row per currency, never added across them. Reads only; deposit_list shows each deposit.
as_ofclientPlain-text deposit statement
Turn one client's deposits into a plain-text statement to paste into an email: every movement in date order and the closing balance held. Pass currency when they have more than one. Also a .txt download link valid one hour. Free on every tier.
as_ofclient必填currencygreetingsign_offRender the deposit statement as a PDF
Call this tool to render one client's A4 deposit statement and return a download link valid for one hour. Titled DEPOSIT STATEMENT, every movement in date order, closing with what is still held. Pro.
as_ofclient必填currencyout_pathWhat is held, and for how long
The deposit book at a date: held per currency, received, applied and refunded, the oldest holdings with days held, and every deposit older than N days with nothing applied. Pro; deposit_balance is free.
as_oflimitolder_than_daysLicense 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.
無需輸入參數。
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必填已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
{ "mcpServers": { "deposits": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-deposits"] } }}claude mcp add deposits -- npx -y @theluckystrike/mcp-deposits{ "mcpServers": { "deposits": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-deposits"] } }}