Document Generator

You run a Document Generator MCP Server that builds DOCX and PDF documents through flexible transports. You can interact locally via STDIO for CLI workflows or expose an HTTP API for networked clients, enabling incremental document building, rich styling, and easy access to generated files.

How to use

You can use the MCP server with a client that speaks MCP. Start in STDIO mode for local tooling or switch to HTTP mode to serve multiple clients over the network. In STDIO mode you interact through standard input/output and each client runs its own server process. In HTTP mode you run a web server on a chosen host and port and accept multiple concurrent clients.

How to install

Prerequisites: Python must be installed on your system. You may also use a tooling layer to manage environments and command wrappers.

# Quick start in STDIO mode (local CLI)
uv venv
uv pip install -e .
uv run python main.py

# Quick start in HTTP mode (network access)
python main.py --transport http --host 0.0.0.0 --port 8000
uv run python main.py --transport http --host 0.0.0.0 --port 8000

Configuration and transport modes

The server supports two transports. STDIO uses standard input/output for local CLI tools, while HTTP runs a web server on a configurable port to handle multiple clients. The default STDIO workflow is suitable for desktop tools, and HTTP is ideal when you need network access.

HTTP access URL pattern: http://host:port/mcp. Bindings for HTTP are shown when starting the server with transport http and host and port options.

Examples

Create a simple document in a single call or build it incrementally across a session, then save as DOCX or PDF. You can access generated documents via MCP Resources.

Common scenarios include starting a session, adding content step by step, and saving the final document in your preferred format.

Testing and quick validation

Run the server in STDIO or HTTP mode and verify the workflow using an MCP client or basic HTTP requests to the server endpoint. You can test end-to-end document creation and retrieval from your client.

Available tools

create_docx

Create a complete DOCX document in one call, including title, paragraphs, and tables, with options to return the file as base64.

create_pdf

Create a PDF document with a structure similar to DOCX, including text and tables.

create_document_session

Start a session to build a document incrementally across multiple calls.

add_paragraph

Add a paragraph to an existing document within a session, with optional styling.

add_table

Add a table to an existing document within a session.

save_document

Save a session-based document as DOCX or PDF.

list_documents

List all documents generated in the current session.