TemplateFox MCP Server

MCP (Model Context Protocol) сервер для TemplateFox API генерации PDF. Генерируйте PDF из шаблонов напрямую через ИИ-ассистентов, таких как Claude, Cursor и Windsurf.

Установка

Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на 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

Затем установите переменную окружения TEMPLATEFOX_API_KEY в вашей оболочке.

Cursor / Windsurf

Используйте ту же команду npx -y @templatefox/mcp-server в конфигурации вашего MCP-сервера, с TEMPLATEFOX_API_KEY в окружении.

Глобальная установка (альтернатива)

npm install -g @templatefox/mcp-server

Затем используйте templatefox-mcp-server в качестве команды вместо npx.

Related MCP server: @docujson/mcp

Конфигурация

Доступные инструменты

Удалённый сервер (HTTP)

MCP-сервер также поддерживает HTTP-транспорт через Streamable HTTP, подходящий для удалённых и облачных развёртываний.

Подключение через URL

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

MCP-клиенты должны передавать API-ключ через HTTP-заголовок:

Authorization: Bearer sk_your_api_key_here

или:

x-api-key: sk_your_api_key_here

Самостоятельное размещение

Запустите сервер в HTTP-режиме, установив переменную окружения PORT:

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

Или с помощью Docker:

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

MCP-эндпоинт доступен по адресу http://localhost:8080/mcp, а проверка здоровья — по адресу http://localhost:8080/health.

Пример использования

После настройки вы можете попросить вашего ИИ-ассистента:

«Список моих PDF-шаблонов и сгенерируйте счёт, используя шаблон Invoice с именем клиента 'John Doe' и суммой 150.00»

Ассистент выполнит:

1. Вызовет list_templates, чтобы найти доступные шаблоны

2. Вызовет get_template_fields, чтобы узнать обязательные поля

3. Вызовет generate_pdf с ID шаблона и данными

4. Вернёт URL для скачивания PDF

Ссылки

• Документация TemplateFox

• Справочник API

• Получить API-ключ

• GitHub

Лицензия

MIT