docforge-mcp 0.1.0__py3-none-any.whl

config.py

@@ -0,0 +1,389 @@
+"""Centralized configuration and logging setup for the MCP Office Documents server.
+
+This module is the single source of truth for reading and validating environment
+variables. No other module should access os.environ directly.
+
+Highlights:
+- Reads all env vars and constructs a typed Config instance (Pydantic v2).
+- Validates required settings based on chosen upload strategy (LOCAL/S3/GCS/AZURE).
+- Configures global logging (format and level) exactly once on first access.
+- Exposes get_config() to retrieve a singleton Config across the app.
+
+Environment variables (see .env.example for full list):
+- Logging: DEBUG (true/false)
+- Storage generic: UPLOAD_STRATEGY, SIGNED_URL_EXPIRES_IN
+- Strategy specific: AWS_*, GCS_*, AZURE_*
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+from enum import Enum
+from typing import Optional
+
+from dotenv import load_dotenv
+from pydantic import BaseModel, Field, ValidationError, model_validator
+
+# Load .env file if present (local development). Existing env vars are NOT
+# overwritten, so in Docker (where env_file sets them) this is a safe no-op.
+load_dotenv()
+
+
+class LogLevel(str, Enum):
+    """Application log levels (restricted to INFO and DEBUG)."""
+    DEBUG = "DEBUG"
+    INFO = "INFO"
+
+
+class LoggingSettings(BaseModel):
+    """Logging configuration simplified to a single DEBUG flag.
+
+    Behavior:
+    - If DEBUG env var is truthy (1/true/on), logging is DEBUG.
+    - Otherwise logging is INFO.
+
+    Exposes convenience properties used across the app:
+    - level_no: numeric logging level
+    - mcp_level_str: lower-case string for FastMCP's `log_level` argument
+    """
+    debug: bool = Field(default=False, description="True to enable DEBUG level, False for INFO")
+
+    @property
+    def level_no(self) -> int:
+        return logging.DEBUG if self.debug else logging.INFO
+
+    @property
+    def mcp_level_str(self) -> str:
+        """Return lower-case string for FastMCP `log_level` argument."""
+        return "debug" if self.debug else "info"
+
+
+class S3Settings(BaseModel):
+    """Configuration for AWS S3 uploads.
+
+    Credential resolution follows a layered approach:
+
+    1. **Explicit credentials** — Set ``AWS_ACCESS_KEY`` and
+       ``AWS_SECRET_ACCESS_KEY`` environment variables. Can be used for local
+       development or non-AWS environments. ``AWS_REGION`` is also required
+       when using explicit credentials.
+    2. **AWS default credential chain** — When
+       the explicit credential env vars are *NOT* set, the boto3 SDK
+       automatically discovers credentials from (in order):
+       - Environment variables (``AWS_ACCESS_KEY_ID``, ``AWS_SECRET_ACCESS_KEY``,
+         ``AWS_SESSION_TOKEN``, ``AWS_DEFAULT_REGION``)
+       - Shared credential / config files (``~/.aws/credentials``,
+         ``~/.aws/config``)
+       - **AWS SSO / ``aws sso login`` sessions** — for local
+         development after running ``aws sso login``
+       - ECS container credentials
+       - **IRSA (IAM Roles for Service Accounts)** — for pods running on
+         **AWS EKS**
+       - EC2 instance metadata (IMDSv2)
+
+    ``S3_BUCKET`` is always required regardless of the credential method.
+    ``AWS_REGION`` is optional when using the default credential chain — boto3
+    will resolve the region from the environment, config files, or instance
+    metadata.
+    """
+    access_key: Optional[str] = None
+    secret_key: Optional[str] = None
+    region: Optional[str] = None
+    bucket: str
+
+    @model_validator(mode="after")
+    def _validate(self) -> "S3Settings":
+        """Validate S3 settings.
+
+        - ``bucket`` is always required.
+        - If explicit credentials are partially provided (only one of
+          access_key / secret_key), raise an error — either provide both
+          or neither.
+        - When explicit credentials are provided, ``region`` is required
+          because we construct the endpoint URL from it.
+        """
+        # Normalize optional strings by stripping surrounding whitespace and
+        # converting empty strings to None.
+        if self.access_key is not None:
+            self.access_key = self.access_key.strip() or None
+        if self.secret_key is not None:
+            self.secret_key = self.secret_key.strip() or None
+        if self.region is not None:
+            self.region = self.region.strip() or None
+
+        if not self.bucket or not self.bucket.strip():
+            raise ValueError("Missing required S3 setting: S3_BUCKET")
+        self.bucket = self.bucket.strip()
+
+        has_key = self.access_key is not None
+        has_secret = self.secret_key is not None
+        if has_key != has_secret:
+            raise ValueError(
+                "AWS_ACCESS_KEY and AWS_SECRET_ACCESS_KEY must both be set or both be omitted. "
+                "Omit both to use the AWS default credential chain (IRSA, SSO, instance profile, etc.)."
+            )
+
+        if has_key and has_secret and self.region is None:
+            raise ValueError(
+                "AWS_REGION is required when explicit AWS_ACCESS_KEY / AWS_SECRET_ACCESS_KEY are provided."
+            )
+
+        return self
+
+    @property
+    def use_explicit_credentials(self) -> bool:
+        """Return True if explicit AWS credentials were provided."""
+        return self.access_key is not None and self.secret_key is not None
+
+
+class GCSSettings(BaseModel):
+    """Required configuration for Google Cloud Storage uploads.
+
+    When credentials_path is omitted, the client uses Application Default
+    Credentials (ADC), which automatically picks up Workload Identity on GKE.
+    """
+    bucket: str
+    credentials_path: Optional[str] = None
+
+    @model_validator(mode="after")
+    def _non_empty(self) -> "GCSSettings":
+        """Normalize credentials_path and ensure the bucket name is non-empty."""
+        # Normalize credentials_path: treat whitespace-only strings as missing.
+        if self.credentials_path is not None:
+            stripped = str(self.credentials_path).strip()
+            self.credentials_path = stripped or None
+
+        # Validate and normalize bucket.
+        bucket_stripped = str(self.bucket).strip()
+        if not bucket_stripped:
+            raise ValueError("Missing required GCS setting: GCS_BUCKET")
+        self.bucket = bucket_stripped
+        return self
+
+
+class AzureSettings(BaseModel):
+    """Required configuration for Azure Blob Storage uploads.
+
+    Note: `endpoint` is optional; if empty, defaults to
+    https://<account>.blob.core.windows.net
+    """
+    account_name: str
+    account_key: str
+    container: str
+    endpoint: Optional[str] = None
+
+    @model_validator(mode="after")
+    def _non_empty(self) -> "AzureSettings":
+        """Ensure all required Azure fields are non-empty."""
+        missing = [
+            name for name, val in (
+                ("AZURE_STORAGE_ACCOUNT_NAME", self.account_name),
+                ("AZURE_STORAGE_ACCOUNT_KEY", self.account_key),
+                ("AZURE_CONTAINER", self.container),
+            ) if not str(val).strip()
+        ]
+        if missing:
+            raise ValueError(f"Missing required Azure settings: {', '.join(missing)}")
+        return self
+
+
+class MinioSettings(BaseModel):
+    """Configuration for self-hosted MinIO (S3-compatible) uploads."""
+
+    endpoint: str = Field(description="Base URL of the MinIO server, e.g., http://minio:9000")
+    access_key: str
+    secret_key: str
+    bucket: str
+    region: str = Field(default="us-east-1", description="Region to report to boto3; defaults to us-east-1")
+    verify_ssl: bool = Field(default=True, description="Whether to verify SSL certificates when connecting")
+    path_style: bool = Field(default=True, description="Use path-style addressing (recommended for MinIO)")
+
+    @model_validator(mode="after")
+    def _non_empty(self) -> "MinioSettings":
+        missing = [
+            name for name, val in (
+                ("MINIO_ENDPOINT", self.endpoint),
+                ("MINIO_ACCESS_KEY", self.access_key),
+                ("MINIO_SECRET_KEY", self.secret_key),
+                ("MINIO_BUCKET", self.bucket),
+            ) if not str(val).strip()
+        ]
+        if missing:
+            raise ValueError(f"Missing required MinIO settings: {', '.join(missing)}")
+        return self
+
+
+class StorageStrategy(str, Enum):
+    """Supported upload backends for produced documents."""
+    LOCAL = "LOCAL"
+    S3 = "S3"
+    GCS = "GCS"
+    AZURE = "AZURE"
+    MINIO = "MINIO"
+
+
+class StorageSettings(BaseModel):
+    """Generic storage configuration plus strategy-specific nested settings.
+
+    Note: The LOCAL strategy always writes to the working folder ./app/upload;
+    there is no configurable output directory for LOCAL.
+    """
+    strategy: StorageStrategy = Field(default=StorageStrategy.LOCAL)
+    signed_url_expires_in: int = Field(default=3600, gt=0, description="TTL for S3/GCS/Azure download links in seconds")
+
+    # Optional nested settings depending on strategy
+    s3: Optional[S3Settings] = None
+    gcs: Optional[GCSSettings] = None
+    azure: Optional[AzureSettings] = None
+    minio: Optional[MinioSettings] = None
+
+    @model_validator(mode="after")
+    def validate_strategy_requirements(self) -> "StorageSettings":
+        """Ensure required nested settings exist for chosen strategy."""
+        if self.strategy == StorageStrategy.S3:
+            if not self.s3:
+                raise ValueError("S3 settings are required for S3 strategy")
+        elif self.strategy == StorageStrategy.GCS:
+            if not self.gcs:
+                raise ValueError("GCS settings are required for GCS strategy")
+        elif self.strategy == StorageStrategy.AZURE:
+            if not self.azure:
+                raise ValueError("Azure settings are required for AZURE strategy")
+        elif self.strategy == StorageStrategy.MINIO:
+            if not self.minio:
+                raise ValueError("MinIO settings are required for MINIO strategy")
+        return self
+
+
+class Config(BaseModel):
+    """Top-level configuration container used by the whole application."""
+    logging: LoggingSettings
+    storage: StorageSettings
+    api_key: Optional[str] = Field(
+        default=None,
+        description="API key for authenticating incoming requests. None means no auth.",
+    )
+
+    @staticmethod
+    def _parse_bool(value: Optional[str]) -> bool:
+        """Interpret common truthy representations used in env vars."""
+        if value is None:
+            return False
+        return value.strip().lower() in {"1", "true", "yes", "y", "on"}
+
+    @classmethod
+    def from_env(cls) -> "Config":
+        """Construct Config from environment variables with sensible defaults and validation.
+
+        This does not configure logging by itself; see configure_logging().
+        """
+        # Logging: only use DEBUG env var (truthy -> DEBUG, falsy -> INFO)
+        debug = cls._parse_bool(os.environ.get("DEBUG"))
+        logging_settings = LoggingSettings(debug=debug)
+
+        # Storage
+        raw_strategy = (os.environ.get("UPLOAD_STRATEGY", "LOCAL")).upper()
+        strategy = raw_strategy if raw_strategy in {e.value for e in StorageStrategy} else "LOCAL"
+
+        # Signed URL expiry (fallback to 3600 on invalid input)
+        try:
+            expires_in = int(os.environ.get("SIGNED_URL_EXPIRES_IN", "3600"))
+            if expires_in <= 0:
+                raise ValueError
+        except ValueError:
+            expires_in = 3600
+
+        # Strategy-specific settings (only populate the relevant one)
+        s3_settings = None
+        gcs_settings = None
+        azure_settings = None
+        minio_settings = None
+
+        if strategy == StorageStrategy.S3.value:
+            s3_settings = S3Settings(
+                access_key=os.environ.get("AWS_ACCESS_KEY") or None,
+                secret_key=os.environ.get("AWS_SECRET_ACCESS_KEY") or None,
+                region=os.environ.get("AWS_REGION") or None,
+                bucket=os.environ.get("S3_BUCKET", ""),
+            )
+        elif strategy == StorageStrategy.GCS.value:
+            gcs_settings = GCSSettings(
+                bucket=os.environ.get("GCS_BUCKET", ""),
+                credentials_path=os.environ.get("GCS_CREDENTIALS_PATH") or None,
+            )
+        elif strategy == StorageStrategy.AZURE.value:
+            azure_settings = AzureSettings(
+                account_name=os.environ.get("AZURE_STORAGE_ACCOUNT_NAME", ""),
+                account_key=os.environ.get("AZURE_STORAGE_ACCOUNT_KEY", ""),
+                container=os.environ.get("AZURE_CONTAINER", ""),
+                endpoint=os.environ.get("AZURE_BLOB_ENDPOINT"),
+            )
+        elif strategy == StorageStrategy.MINIO.value:
+            minio_settings = MinioSettings(
+                endpoint=os.environ.get("MINIO_ENDPOINT", ""),
+                access_key=os.environ.get("MINIO_ACCESS_KEY", ""),
+                secret_key=os.environ.get("MINIO_SECRET_KEY", ""),
+                bucket=os.environ.get("MINIO_BUCKET", ""),
+                region=os.environ.get("MINIO_REGION", "us-east-1") or "us-east-1",
+                verify_ssl=cls._parse_bool(os.environ.get("MINIO_VERIFY_SSL", "true")),
+                path_style=cls._parse_bool(os.environ.get("MINIO_PATH_STYLE", "true")),
+            )
+
+        storage_settings = StorageSettings(
+            strategy=StorageStrategy(strategy),
+            signed_url_expires_in=expires_in,
+            s3=s3_settings,
+            gcs=gcs_settings,
+            azure=azure_settings,
+            minio=minio_settings,
+        )
+
+        # API key authentication (optional – empty/missing means no auth)
+        raw_api_key = (os.environ.get("API_KEY") or "").strip() or None
+
+        try:
+            return cls(logging=logging_settings, storage=storage_settings, api_key=raw_api_key)
+        except ValidationError as e:
+            # Wrap Pydantic validation errors in a simpler exception for callers
+            raise ValueError(f"Invalid configuration: {e}")
+
+
+# Singleton instance and guard for one-time logging configuration
+_CONFIG: Optional[Config] = None
+_LOGGING_CONFIGURED: bool = False
+
+
+def configure_logging(config: Config) -> None:
+    """Configure root logger format and level exactly once.
+
+    - Uses a more verbose format (file:line) in DEBUG level.
+    - Keeps concise formatting otherwise.
+    """
+    global _LOGGING_CONFIGURED
+    if _LOGGING_CONFIGURED:
+        return
+
+    level = config.logging.level_no
+    root = logging.getLogger()
+    if not root.handlers:
+        handler = logging.StreamHandler()
+        # Use the debug flag (simplified API)
+        if config.logging.debug:
+            fmt = "%(asctime)s | %(levelname)s | %(name)s:%(lineno)d | %(message)s"
+        else:
+            fmt = "%(asctime)s | %(levelname)s | %(name)s | %(message)s"
+        handler.setFormatter(logging.Formatter(fmt))
+        root.addHandler(handler)
+    root.setLevel(level)
+    _LOGGING_CONFIGURED = True
+
+
+def get_config() -> Config:
+    """Return the process-wide Config singleton and ensure logging is configured."""
+    global _CONFIG
+    if _CONFIG is None:
+        cfg = Config.from_env()
+        configure_logging(cfg)
+        _CONFIG = cfg
+    return _CONFIG

docforge_mcp-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,59 @@
+docx_tools/__init__.py,sha256=-tB13zkY7mq6uC1vQ2y8VRS3MKFnuZ2P4c40R6OoGXs,191
+docx_tools/base_docx_tool.py,sha256=JfoHBHDjFlmXpz5vsyoFGeS5fLt6cDKW9ADNBHMUMk8,8105
+docx_tools/conditional_templates.py,sha256=J8tOVqtalDgdNASlhuiXSn1BK2sXkx5IiDimuvLU-7M,3854
+docx_tools/dynamic_docx_tools.py,sha256=orRP9qf0szpq7JZKdw_t2cbXdhf98Q52Te22z9D5aKc,19370
+docx_tools/helpers.py,sha256=LHk4gadajWB3v31sVfRyfccXgD04YLvwjsGL4X8j1Q8,24987
+docx_tools/advanced/__init__.py,sha256=m98EfvjCxec94C1TSUCAYA5vjrhLU6DAINUOl3E5lB4,413
+docx_tools/advanced/features.py,sha256=yPDAhEmYh1GuhrVyIwiuiwROvZmPyTRSD_GSdoRUXJk,3933
+edit_tools/__init__.py,sha256=85zs1dL3jYzmPDtkQukga__G3eeEIzww7tftqECJ2WQ,641
+edit_tools/docx_editor.py,sha256=wh1mj19laV-Icma-G2JJqJgoO0bQO4zaPs7BhedSu3U,3327
+edit_tools/pptx_editor.py,sha256=oo90BzFmGKgbza3eqi_jNo3rW5caAB-dgSzhqwHIHbo,2335
+edit_tools/xlsx_editor.py,sha256=ejynFl4bOFlNll3TN3j7Ajuyx1EWXdsjbH3LrUTtGBY,2000
+email_tools/__init__.py,sha256=wXJ38twMrLdj0u2fHqL_7RrxzkywTZwoWOs3vjWg6wQ,316
+email_tools/base_email_tool.py,sha256=JcoshRKE5QDC-53YgvACejRKt6WA6_UsnZx3b0AhfEA,4042
+email_tools/dynamic_email_tools.py,sha256=Ood8DXdbjNQfLuBaDVOxfb4TAHN2GPY5zz7KUD0qa78,8695
+mcp_office_documents/__init__.py,sha256=4-NTLmaHjZItY3qtL49ouIt5CJgbZj6TZzclgPEWWMc,109
+mcp_office_documents/app.py,sha256=9lxBo6028a2dbzVxcat58UYohGMx1hP__aSOMDk96vs,42102
+mcp_office_documents/server.py,sha256=7aUFw5q12g8TYPoru-Q0e1W_wG9ngoF-6yMM8kNbke8,1023
+merge_tools/__init__.py,sha256=GB6fXZmzA66njxy2kEErzqEElnNdovLjHuWgqAFNXvE,152
+merge_tools/merger.py,sha256=hpSCI5nO09tkaStVr_td6wSXHGMlgrLbDwrGA2MCW-k,1513
+pdf_tools/__init__.py,sha256=o5sS-o-cct-CW4MhgAYRsXN1UGD6_NxiwgJKhC55_OA,182
+pdf_tools/base_pdf_tool.py,sha256=kh3xrvWtsEa9e-_LmSEetBM2W8ufjTjByZqCjNcUKLU,4557
+pptx_tools/__init__.py,sha256=D02b_ynI68WqoPfiT4bD52AunSMCZlMznbckEfj9vMA,474
+pptx_tools/base_pptx_tool.py,sha256=egLH6e5vQXWb4NTkznksuMG9k3JIAKc7fNI1Vxtk-3A,1350
+pptx_tools/chart_utils.py,sha256=7ehwIdMFXzdq-gVdPmHYXOjU-THlyD_cHMBqCekMrb8,5495
+pptx_tools/constants.py,sha256=KkuSAAADPvQTtYNcs6YluKEaD-D3cHMG9yrty7riXC0,1757
+pptx_tools/helpers.py,sha256=MUPFT5dwGQpeyvPd_0n5VaDF71je9ZEvFeXkCcnofPo,14276
+pptx_tools/image_utils.py,sha256=_m06rT14_pvfq_bK4RglU5IS0UrA8M0fuhhieUHpIVA,6805
+pptx_tools/slide_builder.py,sha256=NacHw2oAIHcNwiy7bB51xgu4romiTHoFfgbYqe3KBjo,14372
+pptx_tools/advanced/__init__.py,sha256=I7TBtGEpQ1euvNE63o2tYTlie_AC5uYOY7Y3oOUJhaQ,316
+pptx_tools/advanced/features.py,sha256=0m5paFh5D5AIAnB4dvzfG1J5Wt3TLPt6Dztj8AWGGI4,3962
+read_tools/__init__.py,sha256=tz0Ki1LeO_yeHuySUzU-rykMx_sYTOsbHyqbesMSs84,520
+read_tools/docx_reader.py,sha256=j-skoYnSq0u_CagJ9mkF69TiU49uH8ojJjlBOqVBNPg,1820
+read_tools/pptx_reader.py,sha256=n17xGH9twv85LNxmjQiOT-GHTbOwrvKtAvlNyak8Yh0,2030
+read_tools/xlsx_reader.py,sha256=PB0D4xOuuDSeyOyX_yrprwr2XECF3bZi9Z84UwzL93Y,2060
+upload_tools/__init__.py,sha256=3rOD2I4grxO5NiSWfX-irLZUCk6ccYMgpjR3IM-08nY,58
+upload_tools/main.py,sha256=L_0g4MuwlROHHXk0GZA1HWEafu-F-fD3I2HrZg9KSpU,3337
+upload_tools/utils.py,sha256=VxssNuVjH6fMH29tzEhyVY6uR_ZyoeNReVD13jAssnU,2130
+upload_tools/backends/__init__.py,sha256=GCpbbMocEO_KyhFMWqJIHO7jOobFKdIhYa-BXaUXwqM,304
+upload_tools/backends/azure.py,sha256=G_a0iAJjj5KzGhc5vydBa-9SUU5M3ov2NN_OD_PaFD4,2359
+upload_tools/backends/gcs.py,sha256=ZNYvh-mCQ6TacS3-tfSrsSWTuacTudZ0uMgdgsdsD_s,3096
+upload_tools/backends/local.py,sha256=YmVzfqYqAZawl1ldBljb0KQ3M-1fGLjlX8uvvbEZUqw,936
+upload_tools/backends/minio.py,sha256=y6302AB5eAE5ly_6C5N4MwJ2Bp4u8BeqUuWW0cPbf-c,2188
+upload_tools/backends/s3.py,sha256=9oM1VzqrnxGEoWxud-ptlaVS_39XxfwnPG2UePls8MI,5115
+xlsx_tools/__init__.py,sha256=92N2lwAHpOTpnLGaPpeVAPRaDr2tMeAZLsX1Ej_E5Zo,89
+xlsx_tools/base_xlsx_tool.py,sha256=283wJj8poArHZlbTAhPangm2urvvXrnS5HsjdWkB1AU,7347
+xlsx_tools/formatting.py,sha256=QGGEPTYfl0TiUt9zTHtXyNcSEpnzdJYNx9o5z2Um0FY,3080
+xlsx_tools/helpers.py,sha256=uCyk7T1URRdVIrLjJfCQIzrYNKiXkxB9PqpMAljSS9o,15306
+xlsx_tools/charts/__init__.py,sha256=XX_cc19dEyFy69NWIpGyUBPPC7oWMPuiOWfdxskfjFU,143
+xlsx_tools/charts/chart_builder.py,sha256=AajtOYVIZeaGTUNVXY0436pbkAdMcFcYe2z8UyFhXqA,3622
+xml_tools/__init__.py,sha256=w2Mo7__yNxn9WnAwdbjgARJw3P4dbrIElxUJz99VK3g,163
+xml_tools/base_xml_tool.py,sha256=3Spnta4wXD82_-T-HdR4BBEdums9M5h_BFTUDi_wVaA,3776
+config.py,sha256=BIZns95Jhv2_ko2HRXd6VZsUFSx7ICPf43jCF80LH1w,15188
+middleware.py,sha256=0aj86-CNbwvW2XyDFxpac89qFONNE4DioUiMJZYCETo,4112
+template_utils.py,sha256=zetBJiODceS_MIv_Sfxpc2BPSQQc_TpBhJZa4RsR5LQ,4045
+docforge_mcp-0.1.0.dist-info/METADATA,sha256=Y1XiVbRYyDqSt5waYXgslOmkSZBrGwpfjTZHSeh_vfg,4562
+docforge_mcp-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+docforge_mcp-0.1.0.dist-info/entry_points.txt,sha256=fHSUxIS7vhLHvsttaz0gvIS5l1Km6V6GdI6echcuh5Q,125
+docforge_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=5FW67cyw2o5VQGMkPQucnpbbuHfwbKxcxbiRptyRJZY,1109
+docforge_mcp-0.1.0.dist-info/RECORD,,

docforge_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

docforge_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+docforge-mcp = mcp_office_documents.server:main
+mcp-ms-office-documents = mcp_office_documents.server:main

docforge_mcp-0.1.0.dist-info/licenses/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.

docx_tools/__init__.py

@@ -0,0 +1,5 @@
+from .base_docx_tool import markdown_to_word
+from .dynamic_docx_tools import register_docx_template_tools_from_yaml
+
+__all__ = ["markdown_to_word", "register_docx_template_tools_from_yaml"]
+

docx_tools/advanced/__init__.py

@@ -0,0 +1,19 @@
+"""Advanced DOCX features: images, headers/footers, layout, lists."""
+
+from docx_tools.advanced.features import (
+    add_bullet_list,
+    add_header_footer,
+    add_image_to_docx,
+    add_numbered_list,
+    merge_table_cells,
+    set_page_margins,
+)
+
+__all__ = [
+    "add_image_to_docx",
+    "add_header_footer",
+    "set_page_margins",
+    "add_bullet_list",
+    "add_numbered_list",
+    "merge_table_cells",
+]