Skip to content
Back to search

GenFilesMCP

GenFilesMCP: Minimal MCP Server for Open Web UI. Generates PPTX, XLSX, DOCX or MD files using user requests and full chat context. *Pull Requests are welcome 😁! Please make sure they are always submitted against the dev branch 🧐

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/baronco--genfilesmcp/badge.svg)](/listings/baronco--genfilesmcp)

HTML

<a href="/listings/baronco--genfilesmcp"><img src="/api/listings/baronco--genfilesmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installation

To quickly get started, you can use the pre-built Docker image:

docker pull ghcr.io/baronco/genfilesmcp:v0.3.0

Run the container:

docker run -d --restart unless-stopped -p 8016:8016 \
  -e OWUI_URL="http://host.docker.internal:3000" \
  -e PORT=8016 \
  -e REVIEWER_AI_ASSISTANT_NAME="GenFilesMCP" \
  -e ENABLE_CREATE_KNOWLEDGE=false \
  --name gen_files_mcp \
  ghcr.io/baronco/genfilesmcp:v0.3.0

Or copy and paste this one-liner:

docker run -d --restart unless-stopped -p 8016:8016 -e OWUI_URL="http://host.docker.internal:3000" -e PORT=8016 -e REVIEWER_AI_ASSISTANT_NAME="GenFilesMCP" -e ENABLE_CREATE_KNOWLEDGE=false --name gen_files_mcp ghcr.io/baronco/genfilesmcp:v0.3.0

Environment Variables

| Variable | Description | Example | |------------------------------|-----------------------------------------------------------------------------|-----------------------------------------| | `OWUI_URL` | URL of your Open Web UI instance | `http://host.docker.internal:3000` | | `PORT` | Port where the MCP Server will listen | `8016` | | `MCP_TRANSPORT` | MCP transport used at startup. Use `streamable-http` for direct HTTP deployments such as Open WebUI external tools, or `stdio` when the server is launched by MCPO or another stdio-capable MCP client. | `streamable-http` | | `OWUI_API_KEY` | API key used only for `stdio` deployments through MCPO, where Open WebUI cannot forward the active user's bearer token through the `Open WebUI -> MCPO -> stdio MCP` chain. Do not use it for direct `streamable-http` deployments. | `sk-017374a....` | | `KNOWLEDGE_COLLECTION_NAME` | Name of the Open WebUI knowledge collection used for generated and reviewed files when `ENABLE_CREATE_KNOWLEDGE=true`. | `My Generated Files` | | `REVIEWER_AI_ASSISTANT_NAME` | Author name used inside Word comments created by `review_docx`. | `GenFilesMCP` | | `ENABLE_CREATE_KNOWLEDGE` | Controls whether generated or reviewed files are attached to Open WebUI knowledge collections. In direct `streamable-http` mode this is optional. In `stdio` through MCPO it must be `true`. | `false` | | `ENABLE_WORD_ELEMENT_FILLING`| Experimental DOCX mode. `false` keeps the code-generation flow; `true` switches to the structured element-based builder. | `false` |

For more detailed installation instructions, see the [Installation Guide](docs/installation.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 123 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # GenFiles MCP Server 🧩
  2. GenFiles is an MCP Server that generates PowerPoint, Excel, Word, or Markdown files from user requests and chat context. This server executes Python templates or structured document builders to produce files, uploads them to an Open Web UI (OWUI) endpoint, and can persist them in Open WebUI knowledge collections depending on the selected transport and configuration. Additionally, it supports analyzing and reviewing existing Word documents by extracting their structure and adding comments for corrections, grammar suggestions, or idea enhancements.
  3. ## Table of Contents
  4. - [Features](docs/features.md) ✨
  5. - Highlights the key capabilities of GenFiles MCP Server.
  6. - Learn about file generation, OWUI integration, and more.
  7. - [Installation](docs/installation.md) βš™οΈ
  8. - Two deployment modes:
  9. - **MCP HTTP Streamable**: Direct HTTP service.
  10. - **MCP Stdio via MCPO**: Integrated with MCPO.
  11. - Get the suggested system prompt for your AI Assistant
  12. - Get the built-in tool `Chat Context Tool` for retrieving docx files and images uploaded in the chat for use in generation or review.
  13. - Step-by-step setup instructions.
  14. - [Usage Examples](docs/usage.md) πŸ“„
  15. - See how to generate DOCX, XLSX, PPTX files.
  16. - Learn how to review Word documents with AI comments.
  17. > 🚨 Please follow the installation instructions step by step to avoid errors.
  18. ## Quick Start (MCP HTTP Streamable) [Installation Guide](docs/installation.md).
  19. ### Installation
  20. To quickly get started, you can use the pre-built Docker image:
  21. ```bash
  22. docker pull ghcr.io/baronco/genfilesmcp:v0.3.0
  23. ```
  24. Run the container:
  25. ```bash
  26. docker run -d --restart unless-stopped -p 8016:8016 \
  27. -e OWUI_URL="http://host.docker.internal:3000" \
  28. -e PORT=8016 \
  29. -e REVIEWER_AI_ASSISTANT_NAME="GenFilesMCP" \
  30. -e ENABLE_CREATE_KNOWLEDGE=false \
  31. --name gen_files_mcp \
  32. ghcr.io/baronco/genfilesmcp:v0.3.0
  33. ```
  34. Or copy and paste this one-liner:
  35. ```bash
  36. docker run -d --restart unless-stopped -p 8016:8016 -e OWUI_URL="http://host.docker.internal:3000" -e PORT=8016 -e REVIEWER_AI_ASSISTANT_NAME="GenFilesMCP" -e ENABLE_CREATE_KNOWLEDGE=false --name gen_files_mcp ghcr.io/baronco/genfilesmcp:v0.3.0
  37. ```
  38. ### Environment Variables
  39. | Variable | Description | Example |
  40. |------------------------------|-----------------------------------------------------------------------------|-----------------------------------------|
  41. | `OWUI_URL` | URL of your Open Web UI instance | `http://host.docker.internal:3000` |
  42. | `PORT` | Port where the MCP Server will listen | `8016` |
  43. | `MCP_TRANSPORT` | MCP transport used at startup. Use `streamable-http` for direct HTTP deployments such as Open WebUI external tools, or `stdio` when the server is launched by MCPO or another stdio-capable MCP client. | `streamable-http` |
  44. | `OWUI_API_KEY` | API key used only for `stdio` deployments through MCPO, where Open WebUI cannot forward the active user's bearer token through the `Open WebUI -> MCPO -> stdio MCP` chain. Do not use it for direct `streamable-http` deployments. | `sk-017374a....` |
  45. | `KNOWLEDGE_COLLECTION_NAME` | Name of the Open WebUI knowledge collection used for generated and reviewed files when `ENABLE_CREATE_KNOWLEDGE=true`. | `My Generated Files` |
  46. | `REVIEWER_AI_ASSISTANT_NAME` | Author name used inside Word comments created by `review_docx`. | `GenFilesMCP` |
  47. | `ENABLE_CREATE_KNOWLEDGE` | Controls whether generated or reviewed files are attached to Open WebUI knowledge collections. In direct `streamable-http` mode this is optional. In `stdio` through MCPO it must be `true`. | `false` |
  48. | `ENABLE_WORD_ELEMENT_FILLING`| Experimental DOCX mode. `false` keeps the code-generation flow; `true` switches to the structured element-based builder. | `false` |
  49. For more detailed installation instructions, see the [Installation Guide](docs/installation.md).
  50. ## What Can It Do?
  51. - Generate files in multiple formats (PowerPoint, Excel, Word, Markdown).
  52. - Review Word documents with AI-generated comments for grammar and idea enhancements.
  53. - Integrate seamlessly with Open Web UI for file uploads and knowledge management.
  54. ### Examples of Generated Files πŸ“„
  55. #### DOCX Files πŸ“
  56. - **Code-based generation**: The LLM writes Python code to generate the document.
  57. - **Template-based generation**: The LLM defines the structure, and the backend builds the document (best results with Claude Haiku 4.5 and Kimi K2.5, 5.0/5).
  58. <p align="center">
  59. <img src="img/NewDocxGen.png" alt="DOCX Example" />
  60. </p>
  61. - **Reviewer Mode**: Add comments for grammar and idea enhancements.
  62. <p align="center">
  63. <img src="img/docxcomments.png" alt="Reviewer Mode Result Example" />
  64. </p>
  65. #### PPTX Files πŸ“Š
  66. The latest GPT models can generate PowerPoint files with good structure and formatting. You can try gpt-5.2 or gpt-5.4 for best style and formatting results.
  67. <p align="center">
  68. <img src="img/powerpoint2.png" alt="PPTX Example" />
  69. </p>
  70. Example using gpt 5.4:
  71. <p align="center">
  72. <img src="img/powerpoint3.png" alt="PPTX Example Using GPT 5.4" />
  73. </p>
  74. #### XLSX Files πŸ“ˆ
  75. The server can generate Excel files with multiple sheets, tables, and charts. The quality of formatting and structure depends on the model used, with the latest GPT models producing the best results.
  76. <p align="center">
  77. <img src="img/excel2.png" alt="XLSX Example" />
  78. </p>
  79. Example using gpt 5.4:
  80. <p align="center">
  81. <img src="img/excel3.png" alt="XLSX Example Using GPT 5.4" />
  82. </p>
  83. ## Star History
  84. [![Star History Chart](https://api.star-history.com/svg?repos=Baronco/GenFilesMCP&type=date&legend=top-left)](https://www.star-history.com/#Baronco/GenFilesMCP&type=date&legend=top-left)
  85. ## License
  86. This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.