MCP 服务器

@docujson/mcp

Connects AI assistants to DocuJSON for PDF generation, template management, and API operations via natural language. It enables tasks like creating invoices, managing templates, and viewing usage stats through MCP-compatible tools.

README

@docujson/mcp

DocuJSON Model Context Protocol (MCP) server. Connect AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools to DocuJSON for PDF generation, template management, and API key operations via natural language.

What it does

This package is a thin stdio bridge that forwards MCP requests from your AI assistant to the hosted DocuJSON MCP server at https://mcp.docujson.com.

With this connected, you can ask your AI assistant things like:

"Generate an invoice PDF for Acme Corp with 3 line items totaling $4,500"
"Create a weekly status report template"
"Show me my PDF usage this month"
"List all my custom templates"
"Revise the invoice template to use a blue header"

Installation

You don't install it directly — your MCP client (Claude Desktop) runs npx @docujson/mcp on demand.

Setup

1. Get a DocuJSON API key

Sign up at docujson.com/signup
Go to Dashboard → API Keys
Create a new key (starts with dj_)

2. Configure your MCP client

Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the DocuJSON server:

{
  "mcpServers": {
    "docujson": {
      "command": "npx",
      "args": ["-y", "@docujson/mcp"],
      "env": {
        "DOCUJSON_API_KEY": "dj_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. You should see DocuJSON tools available in the tools panel.

Cursor (HTTP — recommended)

Cursor supports the HTTP transport directly, so you don't need this stdio bridge. Use the hosted server URL:

Cursor Settings → MCP → Add server:

Name: docujson
URL: https://mcp.docujson.com?apiKey=dj_your_api_key

Continue, Zed, or other MCP clients

Use the HTTP URL if your client supports it. Otherwise use the stdio config pattern from the Claude Desktop example above.

Available tools

generate_pdf — Generate a PDF from any template
preview_template — Generate a preview (doesn't count toward quota)
list_templates — List all built-in and custom templates
get_template — Get template details and JSON schema
create_custom_template — AI-generate a new template from a description
update_custom_template — Update template metadata or sample data
delete_custom_template — Delete a custom template (requires confirmation)
revise_template — Submit a natural-language revision request
publish_template — Publish a draft template
list_api_keys — List workspace API keys
create_api_key — Create a new API key
revoke_api_key — Revoke (deactivate) an API key
get_usage — Monthly PDF usage stats
get_workspace — Current workspace information
list_integrations — Supported integration platforms
get_integration_script — Code snippet for a specific integration

Full tool reference: docujson.com/mcp

Environment variables

DOCUJSON_API_KEY (required) — Your DocuJSON API key
DOCUJSON_MCP_URL (optional) — Override the MCP server URL. Defaults to https://mcp.docujson.com