English Français العربية

io.github.TemplateFoxPDF/mcp-server

السجل الرسمي الإنتاجية

MCP server for TemplateFox PDF generation API - Generate PDFs from templates via AI assistants

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @templatefox/mcp-server
Claude Code 
claude mcp add io-github-templatefoxpdf-mcp-server -e 'TEMPLATEFOX_API_KEY=<your templatefox_api_key>' -- npx -y @templatefox/mcp-server@1.9.7
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-templatefoxpdf-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@templatefox/mcp-server@1.9.7"
            ],
            "env": {
                "TEMPLATEFOX_API_KEY": "<your templatefox_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • TEMPLATEFOX_API_KEY إلزامي سري Your TemplateFox API key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. TemplateFox MCP Server
  2. Installation
  3. Configuration
  4. Available Tools
  5. Remote Server (HTTP)
  6. Example Usage
  7. Links
  8. License

TemplateFox MCP Server

MCP (Model Context Protocol) server for the TemplateFox PDF generation API. Generate PDFs from templates directly through AI assistants like Claude, Cursor, and Windsurf.

Installation

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}
Claude Code
claude mcp add templatefox -- npx -y @templatefox/mcp-server

Then set the environment variable TEMPLATEFOX_API_KEY in your shell.

Cursor / Windsurf

Use the same npx -y @templatefox/mcp-server command in your MCP server configuration, with TEMPLATEFOX_API_KEY in the environment.

Global Install (alternative)
npm install -g @templatefox/mcp-server

Then use templatefox-mcp-server as the command instead of npx.

Configuration

Environment VariableRequiredDescription
TEMPLATEFOX_API_KEYYesYour API key (starts with sk_). Get one at app.templatefox.com/dashboard/api-keys
TEMPLATEFOX_BASE_URLNoOverride API base URL (default: https://api.templatefox.com)

Available Tools

ToolDescription
generate_pdfGenerate a PDF from a template with dynamic data (1 credit)
generate_pdf_asyncQueue async PDF generation with optional webhook (1 credit)
get_pdf_job_statusCheck the status of an async PDF job
list_pdf_jobsList async PDF generation jobs
list_templatesList all available templates
get_template_fieldsGet the fields/variables for a template
get_account_infoCheck remaining credits and account info
list_transactionsView credit transaction history

Remote Server (HTTP)

The MCP server also supports HTTP transport via Streamable HTTP, suitable for remote and cloud deployments.

Connect via URL
https://mcp-server-599407781746.us-central1.run.app/mcp

MCP clients must pass the API key via HTTP header:

Authorization: Bearer sk_your_api_key_here

or:

x-api-key: sk_your_api_key_here
Self-host

Run the server in HTTP mode by setting the PORT environment variable:

PORT=8080 TEMPLATEFOX_API_KEY=sk_your_key node dist/index.js

Or with Docker:

docker build -t templatefox-mcp .
docker run -p 8080:8080 templatefox-mcp

The MCP endpoint is available at http://localhost:8080/mcp and a health check at http://localhost:8080/health.

Example Usage

Once configured, you can ask your AI assistant:

"List my PDF templates and generate an invoice using the Invoice Template with customer name 'John Doe' and amount 150.00"

The assistant will:

  1. Call list_templates to find available templates
  2. Call get_template_fields to discover required fields
  3. Call generate_pdf with the template ID and data
  4. Return the PDF download URL

License

MIT

الأسئلة الشائعة

ما هو io.github.TemplateFoxPDF/mcp-server؟

MCP server for TemplateFox PDF generation API - Generate PDFs from templates via AI assistants

كيف أثبّت io.github.TemplateFoxPDF/mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add io-github-templatefoxpdf-mcp-server -e 'TEMPLATEFOX_API_KEY=<your templatefox_api_key>' -- npx -y @templatefox/mcp-server@1.9.7. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.TemplateFoxPDF/mcp-server إلى مفتاح API؟

نعم. يتطلب TEMPLATEFOX_API_KEY، وتضبطها في إعداداته.

هل io.github.TemplateFoxPDF/mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.TemplateFoxPDF/mcp-server؟

ينشره TemplateFoxPDF. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.