credit-note

mcp-credit-note

公式 MCP Registry（io.github.theluckystrike/credit-note）に登録されています。 フリーランサーや小規模事業者向けのクレジットノート（クレジットメモ）を、書類の慣例に沿って管理します。請求書に対するクレジット、または単独のクレジットノートを発行できます。受取人、理由（返品、過請求、割引の修正、サービスの問題、その他）、数量、単価、税率を含む明細、通貨を指定します。クレジットノートはすべて下書きとして作成され、修正や削除ができます。確定すると最終的な CN-YYYY-NNNN 番号が割り当てられて内容が固定されます。確定済みのクレジットノートは、クライアントが目にした可能性のある書類だからです。メールに貼り付けられる Markdown、またはそのまま印刷できる自己完結型 HTML ページにレンダリングし、通貨、理由、月ごとのクレジット合計を取得できます。金額はすべて最小通貨単位の整数で扱い、データが外部に送信されることはありません。

theluckystrike が開発しました。

@theluckystrike/mcp-credit-note の npm 公開は保留中のため、現時点では npx -y @theluckystrike/mcp-credit-note を実行すると 404 が返されます。それまでは、リポジトリをクローンしてビルドする方法をご利用ください。

インストール

Claude Desktop

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

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

Claude Code

claude mcp add credit-note -- npx -y @theluckystrike/mcp-credit-note

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に、Claude Desktop と同じエントリーを設定します。

ツール

ツール	説明
credit_note_create	請求書に対する、または単独のクレジットノートを発行します。受取人、理由、数量、最小通貨単位での単価、税率を含む明細、通貨を指定します。CN-DRAFT-YYYY-NNNN の下書きを返します
credit_note_update	下書きの状態にある間に、受取人、理由、明細、通貨、請求書参照、発行日、または備考を修正します。新しい明細を指定すると、古い明細はすべて置き換えられます。確定済みのノートは、名前を指定しても更新できません
credit_note_finalize	最終的な CN-YYYY-NNNN 番号を割り当ててノートを固定します。以降は編集や削除ができず、レンダリングと一覧表示のみ可能です
credit_note_list	番号、受取人、理由、ステータス、発行日、合計を含むクレジットノートの一覧を表示します。受取人、理由、ステータス、発行日の期間で絞り込めます
credit_note_get	CN 番号または下書き ID を指定して、クレジットノートの全内容を読み取ります。すべての明細、税額、合計、理由、備考を確認できます
credit_note_delete	誤って入力した下書きを削除します。確定済みのノートは削除できません。クライアントが目にした可能性のある書類だからです
credit_note_render	メールに貼り付けられる Markdown、またはそのまま印刷できる自己完結型 HTML ページにクレジットノートをレンダリングします。下書きには DRAFT バナーが表示されます
credit_note_summary	確定済みノートの通貨ごとのクレジット合計を、理由別、月別に集計します。オプションで発行日の期間を指定できます
license_status / license_activate	Free または Pro のライセンス状態とキーを確認・設定します

Free と Pro の比較

	Free	Pro
確定済みクレジットノート	生涯 10 件	無制限
下書き（credit_note_create、credit_note_update）	無制限	無制限
下書きの削除（credit_note_delete）	可	可
一覧表示、読み取り（credit_note_list、credit_note_get）	無制限	無制限
レンダリング（credit_note_render）	無制限、1 行のフッター付き	無制限、フッターなし
合計（credit_note_summary）	無制限	無制限

従量制の対象となるのは確定処理です。下書きがクライアントに見せる書類になるのは、この処理を行ったときだからです。それ以外はすべて無料で無制限です。レンダリングされた書類や合計を利用できない無料プランはデモにすぎません。ときどき請求書のクレジットを発行するフリーランサーなら、実際の確定済みクレジットノート 10 件で 1 年間利用できます。

Pro の購入先：https://mcp.zovo.one/buy/credit-note。このサーバー単体で 19 ドル、またはバンドルで 39 ドルです。

丸め規則

すべての金額は最小通貨単位（セント）の整数であり、印刷された書類の計算結果を電卓で再現できるよう、明細の計算方法を記載しています。

1. 単価は最小通貨単位の整数として入力するため、入力時に丸めは発生しません。明細の税抜金額は数量 × 単価を一度だけ四捨五入して求めます。gross = round_half_up(quantity * unit_price_minor)。整数の数量は正確に計算されます。小数の数量（EUR 33.33で2.5時間など）は最も近いセントに丸められ、2.5 × 3333 = 8332.5 は8333に丸められます。銀行丸めで8332になることはありません。
2. 税額は明細ごとに計算し、明細ごとに四捨五入します。tax = round_half_up(gross * rate / 100)。
3. 明細の合計は税抜金額 + 税額です。伝票の合計は、丸め済みの明細金額を単純に整数加算して求めます。

明細ごとに丸めてから合計します。合計が印刷された明細の合計からずれることは、明細上で確認できる丸め誤差の範囲を超えません。そのため、23％の税額行は全体の小計ではなく、23％の明細のみを課税対象とします。

番号付け

下書きには、クライアントには表示されない CN-DRAFT-YYYY-NNNN ID が付与されます。最終的な CN-YYYY-NNNN 番号は確定時にのみ、発行日の年で割り当てられます。また、カウンターはレコードより先に書き込まれるため、クラッシュが発生した場合は番号が欠番になり、再利用されません。下書きには最終番号が付与されず、確定済みの伝票は削除できないため、最終番号に欠番は生じません。

プライバシー

すべてのデータは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/credit-note/ にローカル保存されます。ファイルは notes.json と counter.json の2つです。データが外部に送信されることはなく、アカウントもAPIキーも必要ありません。このサーバーではネットワーク呼び出しも一切行いません。ライセンスキーはオフラインで検証されます。Markdown形式とHTML形式のレンダリング結果はテキストとして返され、このサーバーが書類ファイルを作成することはありません。

theluckystrikeによって開発されました。https://github.com/theluckystrike

これらのドキュメントをMCPサーバーとして使用する

任意のMCPクライアント（Claude、Cursor、Windsurf、VS Code）は、GitMCPを通じてこのリポジトリのドキュメントを直接読み取れます。インストールは不要です。

• ドキュメント用MCP URL：https://gitmcp.io/theluckystrike/mcp-credit-note