mcpField
N
Numerador de facturas

Numerador de facturas

ローカル
nuncaeslupus.github.io金融データ01 週間前に更新
リポジトリ公式サイト

Numerador de facturas について

Numerador de facturas は、PDF 請求書を一括で採番するローカル MCP サーバーです。各ページに番号を付けたコピーを作成し、元ファイルは変更しません。PDF の内容はサーバーに送信されません。

主な機能

  1. 01PDF 請求書の一括採番
  2. 02各ページへの連番スタンプ
  3. 03番号とレイアウトの指定
  4. 04`dry_run` による番号の事前確認
  5. 05既存ファイルの上書き防止

活用シーン

  1. 01ローカルフォルダー内の請求書を採番
  2. 02書き込み前に採番順を確認
  3. 03元ファイルを保ちながら番号付きコピーを作成

MCP 対応

MCP クライアントに `number_invoices` ツールを公開します。ローカルサーバーがファイルパスを受け取り、生成したファイル名を返します。PDF の内容をネットワーク経由で送信することはありません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "nuncaeslupus-numerador-facturas": {
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
起動コマンドnpx -y numerador-facturas-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmnumerador-facturas-mcp0.1.1

ツール

1

掲載時のツール一覧 · 1 週間前に更新

パラメーター型必須説明
endintegerいいえ最後の番号です。これだけを指定すると、ファイル数から最初の番号が計算されます
zipbooleanいいえ番号付き PDF をまとめた ZIP も書き出します
fontenumいいえCourier | Courier-Bold | Courier-Oblique | Courier-BoldOblique | Helvetica | Helvetica-Bold | Helvetica-Oblique | Helvetica-BoldOblique | Times-Roman | Times-Bold | Times-Italic | Times-BoldItalic
x_mmnumberいいえその端からの距離（mm）
y_mmnumberいいえその端からの距離（mm）
colorstringいいえ番号の色、#rrggbb
mergebooleanいいえすべての請求書を結合した PDF も書き出します
pathsarrayはいPDFファイルの絶対パス、または対象となるすべてのPDFを含むフォルダー（再帰的には検索しません）
startintegerいいえ開始番号。デフォルトは 1
from_xenumいいえ水平方向の基準辺left | right
from_yenumいいえ垂直方向の基準辺top | bottom
dry_runbooleanいいえ各ファイルに割り当てられる番号を報告し、何も書き込みません
size_ptnumberいいえフォントサイズ（ポイント単位）
sort_byenumいいえname：自然順（2 を 10 より前に配置）。date：変更日時が古いものを先にします。given：記載順name | date | given
passwordstringいいえ保護された PDF のパスワード。チャット経由で渡されるため、ツールがロックされたファイルを報告した場合にのみ尋ねてください。番号付きコピーは保護されません。
templatestringいいえマーカーを 1 つ含む番号形式：{n:4} は 4 桁にゼロ埋め（0007）、{n} はゼロ埋めなし
box_colorstringいいえボックスの色、#rrggbb
backgroundbooleanいいえ数字の背後にボックスを描画する
box_pad_mmnumberいいえ数字とボックスの端の間隔
output_dirstringいいえ結果の絶対パス。デフォルトは最初のファイルの隣にある 'numeradas' です

詳細

numerador-facturas-mcp

LLM が PDF 請求書に一括で番号を付けるための MCP サーバーです。 各請求書のすべてのページに F-0001、F-0002…を印字し、番号付きのコピーを作成します。

ウェブ版と同じコードを使用しており、UI はありません。

プライベートで、ネットワーク接続は不要です。 お使いのコンピューター上でローカルプロセスとして実行されます。LLM から渡されるのはパスのみで、PDF の内容は渡されず、生成されたファイルの一覧だけが返されます。アカウントや接続は不要で、元のファイルは変更されません。LLM に請求書を読むよう依頼した場合は、その内容が LLM プロバイダーに送信されます。

インストール

Claude Desktop： numerador-facturas.mcpb をダウンロードして開きます。

Claude Code：

claude mcp add --scope user numerador-facturas -- npx -y numerador-facturas-mcp

その他の MCP クライアント：

{
  "mcpServers": {
    "numerador-facturas": { "command": "npx", "args": ["-y", "numerador-facturas-mcp"] }
  }
}

Node 20 以降が必要です。サーバーには実行時依存関係がなく、ネットワークリクエストも行いません。npx は起動時に npm に問い合わせて新しいバージョンを確認しますが、請求書の情報は一切送信しません。それも避けたい場合は、.mcpb を使用してください。

使い方

通常どおり依頼してください：「このフォルダーの請求書に F-0500 から番号を付けて」。

number_invoices ツールは、ウェブ版と同じオプション（テンプレート、開始番号または終了番号、並べ替え、位置、フォント、枠、結合 PDF、ZIP）に加え、何も書き込まずに番号を確認するための dry_run を受け付けます。

ウェブ版とは異なり、ファイルが保護されている場合、または破損や不完全な状態が検出された場合は、番号に欠番が生じないよう、どのファイルにも番号を付けません。確認では PDF の構造を調べます。ページの内容に含まれる破損は検出されない場合があります。また、既存のファイルは上書きせず、書き込みに失敗した場合は、書き込まれたファイルを削除します。いずれかのページの範囲外になる位置は拒否しますが、番号全体が収まるかどうかは確認しません。保護された PDF のコピーにはパスワードが設定されません。

公開

バージョンは package.json、manifest.json、server.json に記載され、これらが一致していることをテストで確認します。初回は、mcp/ から npm にログインした状態で次を実行します。

npm publish --access public

その後、npm で trusted publisher（リポジトリ nuncaeslupus/numerador-facturas、ワークフロー release-mcp.yml）を設定してください。次のバージョンは mcp-vX.Y.Z タグをプッシュすると公開され、npm と MCP レジストリに登録されます。初回は自動ではレジストリに登録されないため、npm への公開後にタグもプッシュしてください。main にマージする前に npm へ公開してください。ウェブ版ではこのパッケージ名を案内しているため、それまでは誰でもこの名前を登録できてしまいます。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。