docforge-mcp 0.1.0__tar.gz

docforge_mcp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly

docforge_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: Lint & Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Run ruff linter
+        run: ruff check .
+
+      - name: Run tests with coverage
+        run: pytest --tb=short -q --ignore=tests/test_s3_upload.py
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: lint-and-test
+    if: startsWith(github.ref, 'refs/tags/v')
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

docforge_mcp-0.1.0/.github/workflows/codeql.yml

@@ -0,0 +1,23 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  schedule:
+    - cron: '0 6 * * 1'
+
+permissions:
+  security-events: write
+  contents: read
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: github/codeql-action/init@v3
+        with:
+          languages: python
+      - uses: github/codeql-action/analyze@v3

docforge_mcp-0.1.0/.gitignore

@@ -0,0 +1,51 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Output directory
+output/
+custom_templates/
+config/
+
+# Temporary files
+*.tmp

docforge_mcp-0.1.0/AGENTS.md

@@ -0,0 +1,88 @@
+# AGENTS.md — docforge-mcp
+
+## Project Overview
+
+MCP server providing 38 tools for complete Office document manipulation — create, read, edit, convert, merge, and template DOCX, XLSX, PPTX, PDF, and EML files. Designed for AI agents that need full document lifecycle control.
+
+## Architecture
+
+```
+mcp_office_documents/
+├── app.py              # FastMCP server — all 38 tools registered here
+├── server.py           # Entry point (stdio/HTTP transport selection)
+└── __init__.py
+
+docx_tools/             # Word: create, markdown→docx, templates
+├── base_docx_tool.py   # create_word_from_markdown
+├── conditional_templates.py  # render_docx_template (if/unless/each)
+├── dynamic_docx_tools.py     # Dynamic tools from YAML templates
+└── helpers.py
+
+xlsx_tools/             # Excel: create, charts, formatting
+├── base_xlsx_tool.py   # create_excel_from_markdown
+├── formatting.py       # apply_excel_formatting (color scale, highlight, data bar)
+└── helpers.py
+
+pptx_tools/             # PowerPoint: create, slides, shapes, images
+├── base_pptx_tool.py   # create_powerpoint_presentation
+├── slide_builder.py    # Slide construction logic
+├── chart_utils.py      # Charts in slides
+└── helpers.py
+
+pdf_tools/              # PDF: create from markdown, convert DOCX→PDF
+├── base_pdf_tool.py
+
+email_tools/            # Email: HTML drafts (.eml)
+├── base_email_tool.py
+├── dynamic_email_tools.py
+
+edit_tools/             # Edit existing documents
+├── docx_editor.py      # edit/insert/delete paragraphs, search/replace
+├── pptx_editor.py      # edit slides, reorder, duplicate, delete
+├── xlsx_editor.py      # edit cells, insert/delete rows
+
+read_tools/             # Read existing documents
+├── docx_reader.py      # get_docx_paragraphs, get_docx_tables
+├── pptx_reader.py      # get_pptx_slides
+├── xlsx_reader.py      # get_xlsx_sheets
+
+merge_tools/            # Merge multiple files
+├── merger.py           # merge_docx_files, merge_pptx_files
+
+xml_tools/              # XML creation
+├── base_xml_tool.py
+
+upload_tools/           # S3/GCS/Azure/MinIO upload
+├── main.py
+
+tests/                  # 16 test files, pytest
+```
+
+## Data Flow
+
+```
+AI Agent → FastMCP (stdio/HTTP) → app.py → {docx,xlsx,pptx,pdf,email,edit,read,merge}_tools → output file
+```
+
+## Key Conventions
+
+- **Transport**: stdio (default) or streamable-http (env `MCP_TRANSPORT=streamable-http`, `MCP_PORT=8958`)
+- **Output**: files saved to `output/` directory (configurable via `OUTPUT_DIR` env)
+- **Templates**: DOCX/PPTX with `{{var}}`, `{{#if cond}}`, `{{#each items}}`
+- **Naming**: snake_case functions, tools named descriptively (`create_word_from_markdown`, `edit_docx_paragraph`)
+- **Errors**: raise ValueError for user errors, let exceptions propagate for bugs
+
+## Adding a New Tool
+
+1. Create function in the appropriate `*_tools/` module
+2. Register in `mcp_office_documents/app.py` with `@mcp.tool()` decorator
+3. Add test in `tests/test_{category}.py`
+4. Run: `pytest --tb=short -q && ruff check .`
+
+## Tests
+
+```bash
+pip install -e ".[dev]"
+pytest --tb=short -q --cov=. --cov-report=term-missing
+ruff check .
+```

docforge_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning: [SemVer](https://semver.org/).
+
+## [0.1.0] - 2026-05-19
+
+### Added
+
+- 38 MCP tools for Office document manipulation
+- **Create**: Word (from markdown), Excel (from markdown), PowerPoint, PDF, Email, XML
+- **Read**: DOCX paragraphs/tables, XLSX sheets, PPTX slides, document metadata
+- **Edit**: DOCX paragraphs (edit/insert/delete/search-replace), XLSX cells/rows, PPTX slides (edit/reorder/duplicate/delete)
+- **Convert**: DOCX → PDF
+- **Merge**: Multiple DOCX or PPTX into one
+- **Templates**: DOCX/PPTX with conditionals (`{{#if}}`), loops (`{{#each}}`), variables
+- **Charts**: Excel charts (bar, line, pie, column)
+- **Formatting**: Excel conditional formatting (highlight, color scale, data bar)
+- stdio + streamable-http transport support
+- CLI entry point: `docforge-mcp`
+- CI: lint + test + publish on tag
+- CodeQL security scanning
+- Dependabot for dependencies
+
+### Changed
+
+- Rebranded from mcp-ms-office-documents to docforge-mcp
+- Independent project (diverged from ForLegalAI upstream in scope)

docforge_mcp-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 ForLegalAI
+Copyright (c) 2026 Claudio Ferreira Filho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

docforge_mcp-0.1.0/MEMORY.md

@@ -0,0 +1,24 @@
+# MEMORY.md — docforge-mcp
+
+## Estado Atual (19/mai/2026)
+
+- **Versão**: 0.1.0 (pre-release, não publicado no PyPI ainda)
+- **Repo**: https://github.com/filhocf/docforge-mcp
+- **Origem**: Fork de ForLegalAI/mcp-ms-office-documents (MIT), divergiu em escopo
+- **Status**: Funcional, 38 tools, 16 arquivos de teste, CI ativo
+
+## Pendente
+
+- [ ] Tag v0.1.0 + publish PyPI (trusted publisher)
+- [ ] Configurar PyPI trusted publisher no GitHub
+- [ ] Atualizar mcp.json local (substituir mcp-ms-office-documents)
+- [ ] Atualizar systemd service (porta 8958)
+- [ ] Gemini Code Assist ativar no repo
+
+## Decisões
+
+- Nome: docforge-mcp (PyPI livre, domínio claro)
+- Filosofia: ecossistema completo (criar+ler+editar+converter) vs upstream one-shot
+- Manter PRs #57/#58/#59 no upstream como contribuição pontual
+- Backward compat: CLI `mcp-ms-office-documents` ainda funciona
+- Licença: MIT dual copyright (ForLegalAI + filhocf)

docforge_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: docforge-mcp
+Version: 0.1.0
+Summary: MCP server for complete Office document manipulation — create, read, edit, convert DOCX/XLSX/PPTX/PDF/EML
+Project-URL: Homepage, https://github.com/filhocf/docforge-mcp
+Project-URL: Repository, https://github.com/filhocf/docforge-mcp
+Project-URL: Issues, https://github.com/filhocf/docforge-mcp/issues
+Author-email: Claudio Ferreira Filho <filhocf@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: docforge,documents,docx,mcp,office,pdf,pptx,xlsx
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.13.4
+Requires-Dist: defusedxml>=0.7.1
+Requires-Dist: fastmcp>=3.2.0
+Requires-Dist: fpdf2>=2.8.0
+Requires-Dist: markdown>=3.5
+Requires-Dist: openpyxl>=3.1.2
+Requires-Dist: pydantic>=2.11.5
+Requires-Dist: pystache>=0.6.5
+Requires-Dist: python-docx==1.2.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: python-pptx==1.0.2
+Requires-Dist: pyyaml
+Requires-Dist: requests>=2.31.0
+Provides-Extra: cloud
+Requires-Dist: azure-storage-blob>=12.23.1; extra == 'cloud'
+Requires-Dist: boto3>=1.40.1; extra == 'cloud'
+Requires-Dist: botocore>=1.40.1; extra == 'cloud'
+Requires-Dist: google-cloud-storage>=2.18.2; extra == 'cloud'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# docforge-mcp
+
+MCP server for **complete Office document manipulation** — create, read, edit, convert, and template DOCX, XLSX, PPTX, PDF, and EML files.
+
+Built for AI agents that need full document lifecycle control, not just one-shot generation.
+
+## Install
+
+```bash
+# Via uvx (no install needed)
+uvx docforge-mcp
+
+# Or install globally
+uv tool install docforge-mcp
+
+# Or pip
+pip install docforge-mcp
+```
+
+## Tools (38)
+
+| Category | Tools | Capabilities |
+|----------|:-----:|--------------|
+| **Word (DOCX)** | 12 | Create from markdown, read, edit paragraphs, insert, delete, search/replace, headers/footers, images, merge, templates |
+| **Excel (XLSX)** | 7 | Create from markdown, read sheets, edit cells, insert/delete rows, charts, conditional formatting |
+| **PowerPoint (PPTX)** | 9 | Create presentations, read slides, edit text, add shapes/images, reorder, duplicate, delete, merge, templates |
+| **PDF** | 3 | Create from markdown, convert DOCX→PDF, read |
+| **Email (EML)** | 1 | Create HTML email drafts |
+| **XML** | 1 | Create well-formed XML |
+| **Templates** | 2 | Render DOCX/PPTX with variables, conditionals (`{{#if}}`), loops (`{{#each}}`) |
+| **Metadata** | 1 | Get document info/stats |
+| **Merge** | 2 | Merge multiple DOCX or PPTX files |
+
+## Usage
+
+### As MCP server (stdio — default)
+
+```bash
+docforge-mcp
+```
+
+### As HTTP server
+
+```bash
+MCP_TRANSPORT=streamable-http MCP_PORT=8958 docforge-mcp
+```
+
+### MCP client configuration
+
+```json
+{
+  "mcpServers": {
+    "office-documents": {
+      "command": "docforge-mcp",
+      "autoApprove": ["read_document", "get_document_info", "get_docx_paragraphs", "get_pptx_slides", "get_xlsx_sheets"]
+    }
+  }
+}
+```
+
+## Origins
+
+This project was born from [ForLegalAI/mcp-ms-office-documents](https://github.com/ForLegalAI/mcp-ms-office-documents) (MIT license). It diverged in scope and philosophy:
+
+| | ForLegalAI (upstream) | docforge-mcp |
+|---|---|---|
+| **Goal** | One-shot document generation | Full document lifecycle |
+| **Read** | ❌ | ✅ Read any DOCX/XLSX/PPTX |
+| **Edit** | ❌ | ✅ Edit paragraphs, cells, slides |
+| **Convert** | ❌ | ✅ DOCX→PDF |
+| **Templates** | Simple `{{var}}` | Conditionals + loops |
+| **Transport** | Docker + HTTP only | stdio + HTTP |
+| **Install** | Docker | `uvx docforge-mcp` |
+
+We continue to contribute compatible features upstream (PRs #57, #58, #59) while developing the full toolkit independently.
+
+## Development
+
+```bash
+git clone https://github.com/filhocf/docforge-mcp.git
+cd docforge-mcp
+uv sync --group dev
+uv run pytest tests/ -v
+uv run ruff check .
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details. Original work © ForLegalAI, extensions © Claudio Ferreira Filho.

docforge_mcp-0.1.0/Readme.md

@@ -0,0 +1,89 @@
+# docforge-mcp
+
+MCP server for **complete Office document manipulation** — create, read, edit, convert, and template DOCX, XLSX, PPTX, PDF, and EML files.
+
+Built for AI agents that need full document lifecycle control, not just one-shot generation.
+
+## Install
+
+```bash
+# Via uvx (no install needed)
+uvx docforge-mcp
+
+# Or install globally
+uv tool install docforge-mcp
+
+# Or pip
+pip install docforge-mcp
+```
+
+## Tools (38)
+
+| Category | Tools | Capabilities |
+|----------|:-----:|--------------|
+| **Word (DOCX)** | 12 | Create from markdown, read, edit paragraphs, insert, delete, search/replace, headers/footers, images, merge, templates |
+| **Excel (XLSX)** | 7 | Create from markdown, read sheets, edit cells, insert/delete rows, charts, conditional formatting |
+| **PowerPoint (PPTX)** | 9 | Create presentations, read slides, edit text, add shapes/images, reorder, duplicate, delete, merge, templates |
+| **PDF** | 3 | Create from markdown, convert DOCX→PDF, read |
+| **Email (EML)** | 1 | Create HTML email drafts |
+| **XML** | 1 | Create well-formed XML |
+| **Templates** | 2 | Render DOCX/PPTX with variables, conditionals (`{{#if}}`), loops (`{{#each}}`) |
+| **Metadata** | 1 | Get document info/stats |
+| **Merge** | 2 | Merge multiple DOCX or PPTX files |
+
+## Usage
+
+### As MCP server (stdio — default)
+
+```bash
+docforge-mcp
+```
+
+### As HTTP server
+
+```bash
+MCP_TRANSPORT=streamable-http MCP_PORT=8958 docforge-mcp
+```
+
+### MCP client configuration
+
+```json
+{
+  "mcpServers": {
+    "office-documents": {
+      "command": "docforge-mcp",
+      "autoApprove": ["read_document", "get_document_info", "get_docx_paragraphs", "get_pptx_slides", "get_xlsx_sheets"]
+    }
+  }
+}
+```
+
+## Origins
+
+This project was born from [ForLegalAI/mcp-ms-office-documents](https://github.com/ForLegalAI/mcp-ms-office-documents) (MIT license). It diverged in scope and philosophy:
+
+| | ForLegalAI (upstream) | docforge-mcp |
+|---|---|---|
+| **Goal** | One-shot document generation | Full document lifecycle |
+| **Read** | ❌ | ✅ Read any DOCX/XLSX/PPTX |
+| **Edit** | ❌ | ✅ Edit paragraphs, cells, slides |
+| **Convert** | ❌ | ✅ DOCX→PDF |
+| **Templates** | Simple `{{var}}` | Conditionals + loops |
+| **Transport** | Docker + HTTP only | stdio + HTTP |
+| **Install** | Docker | `uvx docforge-mcp` |
+
+We continue to contribute compatible features upstream (PRs #57, #58, #59) while developing the full toolkit independently.
+
+## Development
+
+```bash
+git clone https://github.com/filhocf/docforge-mcp.git
+cd docforge-mcp
+uv sync --group dev
+uv run pytest tests/ -v
+uv run ruff check .
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details. Original work © ForLegalAI, extensions © Claudio Ferreira Filho.