@sheetrender/mcp

SheetRender 用の MCP サーバー — AI アシスタントに HTML テンプレートとスプレッドシートデータから PDF をレンダリングする機能を提供します。

セットアップ

API キーを sheetrender.com → 設定 → API キー から取得し、MCP クライアント設定に追加してください:

{
  "mcpServers": {
    "sheetrender": {
      "command": "npx",
      "args": ["-y", "@sheetrender/mcp"],
      "env": { "SHEETRENDER_API_KEY": "sr_live_..." }
    }
  }
}

SHEETRENDER_API_URL も読み取られ、デフォルトは https://sheetrender.com です。セルフホストまたはステージングインスタンスを指す場合にのみ設定してください。

Related MCP server: Dokmatiq DocGen

ツール

render_pdf

提供された HTML から 1 つの PDF をレンダリングします。

保存された PDF のパスとサイズを返します。512 KB 未満の場合は、base64 リソースとしてインラインで添付されるため、添付ファイルを表示するクライアントはドキュメント自体を表示します。

サーバーには 2 つの制限があります。2 MB を超える HTML は拒否されます — 送信した内容と、data を置換した後のドキュメントの両方で測定されるため、長いデータセットを展開するテンプレートは、作成したマークアップが超えていなくても制限を超える可能性があります。また、無料プランでは、レンダリングされたすべての PDF に「Made with SheetRender」フッターが付きます — render_pdf と render_template の両方で同様です。有料プランでは付きません。

list_templates

引数なし。保存された各テンプレートの名前、ID、最終更新日を返します。ユーザーが言及したテンプレート名を、他のツールが必要とする ID に変換するために呼び出します。

render_template

アカウントに保存済みのテンプレートから 1 つの PDF をレンダリングします。

render_pdf と同じ戻り値。

create_batch_job

プロジェクトにアップロード済みのデータセットの行ごとに 1 つの PDF をレンダリングするバックグラウンドジョブをキューに入れます。このサーバーはスプレッドシートをアップロードできません。

get_job でポーリングするジョブ ID を返します。filename_template と group_by はそれぞれテンプレートとプロジェクトに永続化されるため、後続の実行のデフォルトも変更されることに注意してください。

サーバーが公開バッチエンドポイントより前のバージョンの場合、ツールは不明瞭に失敗するのではなく、バッチジョブが利用できないことを報告します。

get_job

job_id を受け取ります。ステータス、完了行数、失敗行数を返し、ジョブが succeeded、partial、failed、cancelled のいずれかに達すると、レンダリングされた各ドキュメントの ID とファイル名を返します。ジョブが queued、retry_queued、running の間はドキュメントリストは空のままです。これらのドキュメント ID が get_document が受け取るものです。

get_document

document_id を受け取り、その単一のレンダリング済み PDF をダウンロードします。ID は完了したバッチの get_job から取得します。他に取得方法はありません。render_pdf と同じ戻り値 — パス、サイズ、512 KB 未満のインラインブロブ。

バッチ全体については、Web アプリの結合 PDF と ZIP が、各ドキュメントを順に取得するよりも優れています。

page_settings

両方のレンダリングツールで共有され、すべてのフィールドは任意です:

{
  "page_size": "a4",
  "orientation": "portrait",
  "margins": { "top": 15, "right": 15, "bottom": 15, "left": 15 }
}

page_size は小文字 — a3、a4、a5、letter、legal、tabloid のいずれかです。マージンは CSS の長さではなく、ミリメートル単位の単なる数値です。

レンダリングされた PDF はシステムの一時ディレクトリに書き込まれます。API からのエラー — 不正なキー、テンプレートの欠落、レート制限 — は、サーバー自身のメッセージを含むツールエラーとして返されます。

公開 API は API キーごとに毎分 120 リクエストを許可します。それを超えると 429 を返し、ツールはレート制限に達したため、しばらくして再試行する必要があると報告します。バッチジョブの作成は別途、より厳しく計測されます。

開発

ホストの node/npm は不要 — scripts/dev.sh install、scripts/dev.sh deno task build。

MIT ライセンス。