bill-of-sale-generator について
車両、機器、在庫商品の売買を記録し、売買証明書を作成するローカル MCP サーバーです。編集可能な草案と確定済みの署名用文書を扱い、Markdown または単独 HTML に出力できます。
主な機能
- 01売買草案の作成と編集
- 02署名用文書の確定
- 03Markdownや印刷用HTMLへの出力
- 04記録の一覧・確認・集計
- 05売買データのローカル保存
活用シーン
- 01VIN付き車両の売買書類を作成
- 02機器や在庫商品の売買記録を草案化
- 03確定書類を印刷して署名
- 04売買記録と合計額を確認
MCP 対応
売買証明書の作成、編集、確定、記録管理をツールとして MCP クライアントに提供します。記録はすべてローカルに保存され、ネットワーク通信はありません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
mcp-bill-of-sale
公式 MCP Registry に登録されています(io.github.theluckystrike/bill-of-sale)。
売買を記録し、署名用に印刷できる売買契約書を作成します。売主、買主、品目の情報に加え、該当する場合は VIN、シリアル番号、IMEI、価格、日付をアシスタントに伝えると、サーバーが当事者、品目、価格、中古品販売向けの現状有姿条項、ご自身の言葉による保証、双方の署名欄を含む書類を作成します。下書きとして編集し、署名用の確定版に仕上げた後、Markdown または単体で完結する HTML ファイルとして印刷できます。この HTML は、ほかのファイルなしで、どのブラウザーからでも PDF に印刷できます。すべてお使いのマシン上で処理されます。このサーバーにアカウントは不要で、ネットワーク通信も一切ありません。
theluckystrike が開発しました。
@theluckystrike/mcp-bill-of-sale の npm 公開は保留中のため、現時点では npx -y @theluckystrike/mcp-bill-of-sale は 404 を返します。それまでは、リポジトリをクローンしてビルドする方法が利用できます。
インストール
Claude Desktop
macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"bill-of-sale": {
"command": "npx",
"args": ["-y", "@theluckystrike/mcp-bill-of-sale"]
}
}
}
Claude Code
claude mcp add bill-of-sale -- npx -y @theluckystrike/mcp-bill-of-sale
Cursor
~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクト)に、Claude Desktop と同じエントリーを追加します。
ツール
| ツール | 機能 |
|---|---|
sale_create | 売買を記録し、売買契約書を作成します。売主、買主、品目、該当する場合は VIN/シリアル番号/IMEI、最小通貨単位での価格、日付を指定します。BOS-YYYY-NNNN を返します。同一の売買を再度登録すると、確認がない限り拒否されます |
sale_update | 署名前の下書きの内容を変更します。価格、当事者、品目の詳細、識別番号、現状有姿条項、保証、メモを変更できます。オプションの項目に空文字列を指定すると、その項目を消去します |
sale_finalize | 下書きを署名用の確定版にします。確定後は sale_update で変更できず、すべての出力から DRAFT の透かしがなくなります |
sale_list | すべての売買契約書を新しい順に表示します。ID、ステータス、日付、品目、買主、売主、価格を確認できます。下書きまたは確定済みの書類に絞り込めます |
sale_get | BOS 番号を指定して、売買契約書の全内容を取得します |
sale_delete | 下書きを完全に削除します。確定済みの書類には confirm_finalized: true が必要です。番号は再発行されないため、番号の欠番が削除の記録になります |
sale_render | 署名欄付きの書類を印刷用に出力します。Markdown、印刷用 PDF に変換できる単体で完結した HTML ファイル、またはその両方を選べます。下書きには DRAFT の透かしが付き、確認用コピーに誤って署名するのを防ぎます |
sale_summary | 下書きと確定済みの件数、通貨ごとの合計金額を一覧で確認できます。異なる通貨の金額は合算されません |
license_status / license_activate | Free または Pro の状態とライセンスキーを確認します |
Free と Pro
| Free | Pro | |
|---|---|---|
| 開いている下書き | 10 | 無制限 |
| 確定済みの書類 | 5 | 無制限 |
Markdown と HTML への出力(sale_render) | 無制限 | 無制限 |
読み取り、一覧表示、集計(sale_get、sale_list、sale_summary) | 無制限 | 無制限 |
削除(sale_delete) | はい | はい |
書類そのものの利用に制限はありません。売買の署名済み記録を保持できるかどうかに答えるのがこのサーバーの役割です。書類を利用できない無料プランでは、デモにすぎません。制限対象となるのは、保持できる記録の数です。未完了の下書きが 10 件、確定済みの書類が 5 件あれば、副業の売買を 1 年間記録するのに十分であり、単なる試用版ではありません。sale_delete が無料なのも、上限が保持する記録数に設定されているのと同じ理由です。下書きを二重に入力した場合、ライセンスキーを使わない限り削除できず、枠を消費することになってしまうためです。
Pro を入手:https://mcp.zovo.one/buy/bill-of-sale。このサーバー単体は一度限りの $19、バンドルは $39 です。
売買の流れ
- 事実情報を使って
sale_createを実行します。プロフィールに名前が設定されている場合、売り手は共有ビジネスプロフィールの名前がデフォルトで使われるため、売り手の情報はスイート全体で一度入力するだけです。 sale_renderを実行して、DRAFT の透かしが入った確認用コピーを印刷します。- 買い手または売り手が見つけた箇所を
sale_updateで修正します。 sale_finalizeで内容を確定します。以降、sale_renderは署名用コピーを印刷します。印刷した用紙に署名するか、HTML を PDF に印刷し、双方がコピーを保管します。
すべての金額は最小通貨単位の整数であり、価格に浮動小数点数を使うことはありません。また、日付は実在する暦日かどうか検証されます。VIN が 17 文字でない場合、または IMEI が 15 桁でない場合は、入力されたとおりに保存されますが、買い手が最も読み違えやすい識別子であるため、レスポンスで警告されます。
プライバシー
すべてのデータはローカルの ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/bill-of-sale/ に保存されます。ファイルは sales.json と counter.json の 2 つで、レンダリングしたドキュメントは documents/ の下に保存されます。データが外部に送信されることはなく、アカウントも API キーも必要ありません。このサーバーはネットワーク呼び出しを一切行いません。ライセンスキーはオフラインで検証されます。
レンダリングされるドキュメントは汎用テンプレートであり、法的助言ではありません。車両、船舶、規制対象品の売買証明書には、販売が行われる地域によって法定書式や届出の要件がある場合があります。
theluckystrike が作成しました。https://github.com/theluckystrike
MCP サーバーとしてこれらのドキュメントを利用する
任意の MCP クライアント(Claude、Cursor、Windsurf、VS Code)から、インストールせずに GitMCP 経由でこのリポジトリのドキュメントを直接読み込めます。
- Docs MCP URL: https://gitmcp.io/theluckystrike/mcp-bill-of-sale
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。