rendoc-mcp-server について
@rendoc/mcp-server は、MCP 対応の AI アシスタントを rendoc に接続し、再利用可能なテンプレートまたはインラインマークアップから PDF を生成します。文書作成とテンプレート管理に対応し、ダウンロード URL を含む構造化結果を返します。
主な機能
- 01テンプレートまたはインラインマークアップから PDF 生成
- 02再利用可能なテンプレートの作成と管理
- 03Handlebars の変数と制御構文
- 04JSON Schema によるデータ検証
- 05用紙サイズと向きの指定
- 06文書詳細と利用状況の確認
活用シーン
- 01請求書、契約書、レポートの作成
- 02保存済みテンプレートから証明書を発行
- 03データセットから PDF を一括生成
MCP 対応
PDF 生成、テンプレート管理、利用状況確認のための 7 つのツールを、stdio 経由で MCP クライアントに提供します。rendoc API に認証付き REST リクエストを送り、PDF のダウンロード URL を含む構造化結果を返します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
7掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| data | object | はい | テンプレートのプレースホルダーに入力するキーと値のデータ。 |
| markup | string | いいえ | インライン HTML/Handlebars マークアップテンプレート。保存済みテンプレートがない場合に使用します。 |
| filename | string | いいえ | 生成する PDF のカスタムファイル名(例:'invoice-2024.pdf')。 |
| paper_size | enum | いいえ | PDF の用紙サイズ。デフォルトは A4 です。A4 | LETTER | LEGAL | A3 | A5 |
| orientation | enum | いいえ | ページの向き。デフォルトは縦向きです。portrait | landscape |
| template_id | string | いいえ | 使用する保存済みテンプレートの ID。markup とは併用できません。 |
詳細
@rendoc/mcp-server
rendoc MCP サーバーを使うと、Claude Desktop、CursorなどのAIアシスタントや、その他のMCP互換クライアントから、プロ品質のPDFドキュメントを必要に応じて生成できます。AIをrendocに接続すれば、再利用可能なテンプレートや、インラインのHTML/Handlebarsマークアップを使い、自然言語のプロンプトだけで、請求書、契約書、レポート、証明書など、あらゆるPDFを作成できます。
*「Acme Corpに、コンサルティング40時間分を時給€85で請求する請求書を作成して」*を、数秒でPDFにしてお届けします。
ユースケース
| ユースケース | プロンプトの例 |
|---|---|
| 請求書 | 「次の明細項目を含む、顧客X向けの請求書を作成して…」 |
| 契約書 | 「TechStart SL向けに、報酬€18,000、50%前払いのフリーランス契約書を作成して…」 |
| 証明書 | 「María Gonzálezのコース修了証明書を発行して…」 |
| レポート | 「次のKPIを含む、2026年3月の売上レポートを作成して…」 |
| 一括生成 | 「このCSVにある参加者50人全員の証明書を作成して」 |
| カスタムドキュメント | HTMLとデータで記述できるものなら何でも |
詳しい手順については、examples/をご覧ください。
特長
- ドキュメント生成、テンプレート管理、使用状況の追跡を行う7つのツール
- テンプレートまたはインライン — 再利用可能なテンプレートを保存するか、その場でマークアップを渡せます
- Handlebars構文 — マークアップで
{{variables}}、{{#each}}、{{#if}}を使用できます - 複数の用紙サイズ — A4、Letter、Legal、A3、A5、縦向きまたは横向き
- スキーマ検証 — テンプレートにJSON Schemaを宣言し、AIが無効なデータを渡せないようにできます
- 設定不要 —
RENDOC_API_KEYを設定するだけです - 軽量 — 展開時約35 KB、純粋なTypeScriptで、実行時依存関係は2つのみ
- Glamaで検証済み — セキュリティ、品質、ライセンスのチェックに合格
Claude Desktopのクイックセットアップ
Claude Desktopの設定ファイル(claude_desktop_config.json)に以下を追加してください。
{
"mcpServers": {
"rendoc": {
"command": "npx",
"args": ["-y", "@rendoc/mcp-server"],
"env": {
"RENDOC_API_KEY": "your-api-key"
}
}
}
}
Claude Desktopを再起動してください。MCPツールメニューにrendocのツールが表示されます。
Claude Codeのクイックセットアップ
プロジェクトまたはグローバル設定(.claude/settings.json)に以下を追加してください。
{
"mcpServers": {
"rendoc": {
"command": "npx",
"args": ["-y", "@rendoc/mcp-server"],
"env": {
"RENDOC_API_KEY": "your-api-key"
}
}
}
}
Cursorのクイックセットアップ
~/.cursor/mcp.json(またはプロジェクトの.cursor/mcp.json)に追加してください。
{
"mcpServers": {
"rendoc": {
"command": "npx",
"args": ["-y", "@rendoc/mcp-server"],
"env": {
"RENDOC_API_KEY": "your-api-key"
}
}
}
}
利用可能なツール
| ツール | 説明 | 主なパラメーター |
|---|---|---|
generate_document | テンプレートまたはインラインのマークアップからPDFを生成 | template_idまたはmarkup、data、paper_size?、orientation?、filename? |
list_templates | 利用可能なドキュメントテンプレートを一覧表示 | category? |
preview_template | テンプレートのマークアップ、スタイル、スキーマを確認 | template_id |
create_template | 再利用可能な新しいテンプレートを作成 | name、slug、markup、schema、category?、styles?、sample_data?、paper_size?、orientation?、is_public? |
delete_template | IDでテンプレートを削除 | template_id |
get_document | 生成したドキュメントの詳細を取得 | document_id |
get_usage | 月ごとのAPI使用統計を表示 | (なし) |
各ツールは、ダウンロードURL、ドキュメントID、アシスタントが操作できるメタデータを含む、構造化されたJSONを返します。
APIキーを取得する
- rendoc.devで登録します
- API Keysダッシュボードに移動します
- 新しいキーを作成し、MCPクライアントの設定にコピーします
環境変数
| 変数 | 必須 | デフォルト | 説明 |
|---|---|---|---|
RENDOC_API_KEY | はい | — | 認証に使用する rendoc API キー |
RENDOC_API_URL | いいえ | https://rendoc.dev | rendoc API のベース URL(セルフホスト型インスタンスで便利です) |
使用例
実際のプロンプトとツール呼び出しを使った詳細な手順:
- 01 — インラインマークアップから請求書を作成 — 1 回の処理で請求書を生成
- 02 — フリーランス契約書のテンプレート — 一度作成すれば、何度でも再利用できます
- 03 — 保存済みテンプレートから証明書を作成 — 複数ステップでのツール検出
- 04 — 月次売上レポート — CSS を使ったリッチな視覚化
- 05 — データセットから一括生成 — 1 つのプロンプトから 50 件の PDF を生成
仕組み
┌──────────────┐ MCP/stdio ┌────────────────────┐ HTTPS ┌─────────────┐
│ Claude Code │ ─────────────▶ │ @rendoc/mcp-server │ ────────▶ │ rendoc API │
│ / Desktop │ │ (this package) │ │ (PDF gen) │
└──────────────┘ ◀───────────── └────────────────────┘ ◀──────── └─────────────┘
▲ tool results download URL
│
└── User prompt: "Generate an invoice for..."
MCP サーバーは、AI アシスタントからの自然言語によるツール呼び出しを、認証済みの rendoc API への REST リクエストに変換し、PDF のダウンロード URL を含む構造化されたレスポンスを返します。
コントリビューション
コントリビューションを歓迎します。開発環境のセットアップと PR のガイドラインについては、CONTRIBUTING.md をご覧ください。
セキュリティ上の問題については、SECURITY.md をご覧のうえ、[email protected] までメールでご連絡ください。公開 issue は作成しないでください。
リンク
- ウェブサイト:rendoc.dev
- ドキュメント:rendoc.dev/docs
- npm パッケージ:
@rendoc/mcp-server - Glama の掲載ページ:glama.ai/mcp/servers/@yoryocoruxo-ai/rendoc-mcp-server
- 公式 SDK:
@rendoc/sdk(TypeScript)、rendoc(Python)
ライセンス
MIT — LICENSE をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。