rossum-mcp 1.0.1__tar.gz

rossum_mcp-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rossum MCP Server Contributors
+
+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.

rossum_mcp-1.0.1/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: rossum-mcp
+Version: 1.0.1
+Summary: MCP server for AI-powered Rossum orchestration: document workflows, debug pipelines automatically, and configure intelligent document processing through natural language.
+Author-email: "Dan Stancl (Rossum AI)" <daniel.stancl@gmail.com>
+License: MIT
+Keywords: mcp,rossum,document-processing
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: pydantic>2.0.0
+Requires-Dist: rossum-api>=3.8.0
+Provides-Extra: docs
+Requires-Dist: myst-parser>=2.0.0; extra == "docs"
+Requires-Dist: sphinx>=7.0.0; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "docs"
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
+Provides-Extra: tests
+Requires-Dist: coverage>=7.0.0; extra == "tests"
+Requires-Dist: pytest>=7.0.0; extra == "tests"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "tests"
+Requires-Dist: pytest-cov>=4.0.0; extra == "tests"
+Requires-Dist: redis>=7.0.0; extra == "tests"
+Provides-Extra: all
+Requires-Dist: coverage>=7.0.0; extra == "all"
+Requires-Dist: fastmcp>=2.0.0; extra == "all"
+Requires-Dist: myst-parser>=2.0.0; extra == "all"
+Requires-Dist: pydantic>2.0.0; extra == "all"
+Requires-Dist: pytest>=7.0.0; extra == "all"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "all"
+Requires-Dist: redis>=7.0.0; extra == "all"
+Requires-Dist: rossum-api>=3.8.0; extra == "all"
+Requires-Dist: sphinx>=7.0.0; extra == "all"
+Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "all"
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == "all"
+Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "all"
+Dynamic: license-file
+
+# Rossum MCP Server
+
+<div align="center">
+
+**MCP server for AI-powered Rossum document processing. 56 tools for queues, schemas, hooks, engines, and more.**
+
+[![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://stancld.github.io/rossum-agents/)
+[![Python](https://img.shields.io/pypi/pyversions/rossum-mcp.svg)](https://pypi.org/project/rossum-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI - rossum-mcp](https://img.shields.io/pypi/v/rossum-mcp?label=rossum-mcp)](https://pypi.org/project/rossum-mcp/)
+[![Coverage](https://codecov.io/gh/stancld/rossum-agents/branch/master/graph/badge.svg?flag=rossum-mcp)](https://codecov.io/gh/stancld/rossum-agents)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-56-blue.svg)](#available-tools)
+
+[![Rossum API](https://img.shields.io/badge/Rossum-API-orange.svg)](https://github.com/rossumai/rossum-api)
+[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![ty](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ty/main/assets/badge/v0.json)](https://github.com/astral-sh/ty)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+
+</div>
+
+> [!NOTE]
+> This is not an official Rossum project. It is a community-developed integration built on top of the Rossum API.
+
+> [!NOTE]
+> API is stable starting from 1.0.0. Breaking changes will follow SemVer (released as 2.0.0+).
+
+## Quick Start
+
+```bash
+# Set environment variables
+export ROSSUM_API_TOKEN="your-api-token"
+export ROSSUM_API_BASE_URL="https://api.elis.rossum.ai/v1"
+
+# Run the MCP server
+uv pip install rossum-mcp
+rossum-mcp
+```
+
+Or run from source:
+
+```bash
+git clone https://github.com/stancld/rossum-agents.git
+cd rossum-mcp/rossum-mcp
+uv sync
+python rossum_mcp/server.py
+```
+
+## Claude Desktop Configuration
+
+Configure Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):
+
+```json
+{
+  "mcpServers": {
+    "rossum": {
+      "command": "python",
+      "args": ["/path/to/rossum-mcp/rossum-mcp/rossum_mcp/server.py"],
+      "env": {
+        "ROSSUM_API_TOKEN": "your-api-token",
+        "ROSSUM_API_BASE_URL": "https://api.elis.rossum.ai/v1",
+        "ROSSUM_MCP_MODE": "read-write"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ROSSUM_API_TOKEN` | Yes | Your Rossum API authentication token |
+| `ROSSUM_API_BASE_URL` | Yes | Base URL for the Rossum API |
+| `ROSSUM_MCP_MODE` | No | `read-write` (default) or `read-only` |
+
+### Read-Only Mode
+
+Set `ROSSUM_MCP_MODE=read-only` to disable all CREATE, UPDATE, and UPLOAD operations. Only GET and LIST operations will be available.
+
+## Available Tools
+
+The server provides **56 tools** organized into categories:
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Document Processing** | 7 | Upload documents, retrieve/update/confirm/delete annotations |
+| **Queue Management** | 9 | Create, configure, delete, and list queues |
+| **Schema Management** | 8 | Define, modify, and delete field structures |
+| **Engine Management** | 6 | Configure extraction and splitting engines |
+| **Extensions & Rules** | 11 | Webhooks, serverless functions, business rules |
+| **Workspace Management** | 4 | Organize and delete workspaces |
+| **User Management** | 3 | List users and roles |
+| **Relations** | 4 | Annotation and document relations |
+| **Email Templates** | 3 | Automated email responses |
+| **Tool Discovery** | 1 | Dynamic tool loading |
+
+<details>
+<summary><strong>Tool List by Category</strong></summary>
+
+**Document Processing:**
+`upload_document`, `get_annotation`, `list_annotations`, `start_annotation`, `bulk_update_annotation_fields`, `confirm_annotation`, `delete_annotation`
+
+**Queue Management:**
+`get_queue`, `list_queues`, `get_queue_schema`, `get_queue_engine`, `create_queue`, `create_queue_from_template`, `get_queue_template_names`, `update_queue`, `delete_queue`
+
+**Schema Management:**
+`get_schema`, `list_schemas`, `create_schema`, `update_schema`, `patch_schema`, `get_schema_tree_structure`, `prune_schema_fields`, `delete_schema`
+
+**Engine Management:**
+`get_engine`, `list_engines`, `create_engine`, `update_engine`, `create_engine_field`, `get_engine_fields`
+
+**Extensions & Rules:**
+`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `delete_rule`
+
+**Workspace Management:**
+`get_workspace`, `list_workspaces`, `create_workspace`, `delete_workspace`
+
+**User Management:**
+`get_user`, `list_users`, `list_user_roles`
+
+**Relations:**
+`get_relation`, `list_relations`, `get_document_relation`, `list_document_relations`
+
+**Email Templates:**
+`get_email_template`, `list_email_templates`, `create_email_template`
+
+**Tool Discovery:**
+`list_tool_categories`
+
+</details>
+
+For detailed API documentation with parameters and examples, see [TOOLS.md](TOOLS.md).
+
+## Annotation Workflow
+
+Documents progress through these states:
+
+```
+importing → to_review → reviewing → confirmed → exporting → exported
+```
+
+**Key points:**
+- Wait for `to_review` before processing
+- Call `start_annotation` before updating fields
+- Call `confirm_annotation` to finalize
+
+## Example Workflows
+
+### Upload and Monitor
+
+```python
+# 1. Upload document
+upload_document(file_path="/path/to/invoice.pdf", queue_id=12345)
+
+# 2. Get annotation ID
+annotations = list_annotations(queue_id=12345)
+
+# 3. Check status
+annotation = get_annotation(annotation_id=annotations[0].id)
+```
+
+### Update Fields
+
+```python
+# 1. Start annotation (moves to 'reviewing')
+start_annotation(annotation_id=12345)
+
+# 2. Get content with field IDs
+annotation = get_annotation(annotation_id=12345, sideloads=['content'])
+
+# 3. Update fields using datapoint IDs
+bulk_update_annotation_fields(
+    annotation_id=12345,
+    operations=[{"op": "replace", "id": 67890, "value": {"content": {"value": "INV-001"}}}]
+)
+
+# 4. Confirm
+confirm_annotation(annotation_id=12345)
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Resources
+
+- [Full Documentation](https://stancld.github.io/rossum-agents/)
+- [Tools Reference](TOOLS.md)
+- [Rossum API Documentation](https://elis.rossum.ai/api/docs/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Main Repository](https://github.com/stancld/rossum-agents)

rossum_mcp-1.0.1/README.md

@@ -0,0 +1,192 @@
+# Rossum MCP Server
+
+<div align="center">
+
+**MCP server for AI-powered Rossum document processing. 56 tools for queues, schemas, hooks, engines, and more.**
+
+[![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://stancld.github.io/rossum-agents/)
+[![Python](https://img.shields.io/pypi/pyversions/rossum-mcp.svg)](https://pypi.org/project/rossum-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI - rossum-mcp](https://img.shields.io/pypi/v/rossum-mcp?label=rossum-mcp)](https://pypi.org/project/rossum-mcp/)
+[![Coverage](https://codecov.io/gh/stancld/rossum-agents/branch/master/graph/badge.svg?flag=rossum-mcp)](https://codecov.io/gh/stancld/rossum-agents)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-56-blue.svg)](#available-tools)
+
+[![Rossum API](https://img.shields.io/badge/Rossum-API-orange.svg)](https://github.com/rossumai/rossum-api)
+[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![ty](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ty/main/assets/badge/v0.json)](https://github.com/astral-sh/ty)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+
+</div>
+
+> [!NOTE]
+> This is not an official Rossum project. It is a community-developed integration built on top of the Rossum API.
+
+> [!NOTE]
+> API is stable starting from 1.0.0. Breaking changes will follow SemVer (released as 2.0.0+).
+
+## Quick Start
+
+```bash
+# Set environment variables
+export ROSSUM_API_TOKEN="your-api-token"
+export ROSSUM_API_BASE_URL="https://api.elis.rossum.ai/v1"
+
+# Run the MCP server
+uv pip install rossum-mcp
+rossum-mcp
+```
+
+Or run from source:
+
+```bash
+git clone https://github.com/stancld/rossum-agents.git
+cd rossum-mcp/rossum-mcp
+uv sync
+python rossum_mcp/server.py
+```
+
+## Claude Desktop Configuration
+
+Configure Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):
+
+```json
+{
+  "mcpServers": {
+    "rossum": {
+      "command": "python",
+      "args": ["/path/to/rossum-mcp/rossum-mcp/rossum_mcp/server.py"],
+      "env": {
+        "ROSSUM_API_TOKEN": "your-api-token",
+        "ROSSUM_API_BASE_URL": "https://api.elis.rossum.ai/v1",
+        "ROSSUM_MCP_MODE": "read-write"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ROSSUM_API_TOKEN` | Yes | Your Rossum API authentication token |
+| `ROSSUM_API_BASE_URL` | Yes | Base URL for the Rossum API |
+| `ROSSUM_MCP_MODE` | No | `read-write` (default) or `read-only` |
+
+### Read-Only Mode
+
+Set `ROSSUM_MCP_MODE=read-only` to disable all CREATE, UPDATE, and UPLOAD operations. Only GET and LIST operations will be available.
+
+## Available Tools
+
+The server provides **56 tools** organized into categories:
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Document Processing** | 7 | Upload documents, retrieve/update/confirm/delete annotations |
+| **Queue Management** | 9 | Create, configure, delete, and list queues |
+| **Schema Management** | 8 | Define, modify, and delete field structures |
+| **Engine Management** | 6 | Configure extraction and splitting engines |
+| **Extensions & Rules** | 11 | Webhooks, serverless functions, business rules |
+| **Workspace Management** | 4 | Organize and delete workspaces |
+| **User Management** | 3 | List users and roles |
+| **Relations** | 4 | Annotation and document relations |
+| **Email Templates** | 3 | Automated email responses |
+| **Tool Discovery** | 1 | Dynamic tool loading |
+
+<details>
+<summary><strong>Tool List by Category</strong></summary>
+
+**Document Processing:**
+`upload_document`, `get_annotation`, `list_annotations`, `start_annotation`, `bulk_update_annotation_fields`, `confirm_annotation`, `delete_annotation`
+
+**Queue Management:**
+`get_queue`, `list_queues`, `get_queue_schema`, `get_queue_engine`, `create_queue`, `create_queue_from_template`, `get_queue_template_names`, `update_queue`, `delete_queue`
+
+**Schema Management:**
+`get_schema`, `list_schemas`, `create_schema`, `update_schema`, `patch_schema`, `get_schema_tree_structure`, `prune_schema_fields`, `delete_schema`
+
+**Engine Management:**
+`get_engine`, `list_engines`, `create_engine`, `update_engine`, `create_engine_field`, `get_engine_fields`
+
+**Extensions & Rules:**
+`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `delete_rule`
+
+**Workspace Management:**
+`get_workspace`, `list_workspaces`, `create_workspace`, `delete_workspace`
+
+**User Management:**
+`get_user`, `list_users`, `list_user_roles`
+
+**Relations:**
+`get_relation`, `list_relations`, `get_document_relation`, `list_document_relations`
+
+**Email Templates:**
+`get_email_template`, `list_email_templates`, `create_email_template`
+
+**Tool Discovery:**
+`list_tool_categories`
+
+</details>
+
+For detailed API documentation with parameters and examples, see [TOOLS.md](TOOLS.md).
+
+## Annotation Workflow
+
+Documents progress through these states:
+
+```
+importing → to_review → reviewing → confirmed → exporting → exported
+```
+
+**Key points:**
+- Wait for `to_review` before processing
+- Call `start_annotation` before updating fields
+- Call `confirm_annotation` to finalize
+
+## Example Workflows
+
+### Upload and Monitor
+
+```python
+# 1. Upload document
+upload_document(file_path="/path/to/invoice.pdf", queue_id=12345)
+
+# 2. Get annotation ID
+annotations = list_annotations(queue_id=12345)
+
+# 3. Check status
+annotation = get_annotation(annotation_id=annotations[0].id)
+```
+
+### Update Fields
+
+```python
+# 1. Start annotation (moves to 'reviewing')
+start_annotation(annotation_id=12345)
+
+# 2. Get content with field IDs
+annotation = get_annotation(annotation_id=12345, sideloads=['content'])
+
+# 3. Update fields using datapoint IDs
+bulk_update_annotation_fields(
+    annotation_id=12345,
+    operations=[{"op": "replace", "id": 67890, "value": {"content": {"value": "INV-001"}}}]
+)
+
+# 4. Confirm
+confirm_annotation(annotation_id=12345)
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Resources
+
+- [Full Documentation](https://stancld.github.io/rossum-agents/)
+- [Tools Reference](TOOLS.md)
+- [Rossum API Documentation](https://elis.rossum.ai/api/docs/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+- [Main Repository](https://github.com/stancld/rossum-agents)

rossum_mcp-1.0.1/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rossum-mcp"
+version = "1.0.1"
+description = "MCP server for AI-powered Rossum orchestration: document workflows, debug pipelines automatically, and configure intelligent document processing through natural language."
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "MIT"}
+authors = [
+    {name = "Dan Stancl (Rossum AI)", email = "daniel.stancl@gmail.com"}
+]
+keywords = ["mcp", "rossum", "document-processing"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "fastmcp>=2.0.0",
+    "pydantic>2.0.0",
+    "rossum-api>=3.8.0",
+]
+
+[project.scripts]
+rossum-mcp = "rossum_mcp.server:main"
+
+[project.optional-dependencies]
+docs = [
+    "myst-parser>=2.0.0",
+    "sphinx>=7.0.0",
+    "sphinx-autodoc-typehints>=1.25.0",
+    "sphinx-copybutton>=0.5.2",
+    "sphinx-rtd-theme>=2.0.0",
+]
+tests = [
+    "coverage>=7.0.0",
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "redis>=7.0.0",
+]
+all = [
+    "coverage>=7.0.0",
+    "fastmcp>=2.0.0",
+    "myst-parser>=2.0.0",
+    "pydantic>2.0.0",
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "redis>=7.0.0",
+    "rossum-api>=3.8.0",
+    "sphinx>=7.0.0",
+    "sphinx-autodoc-typehints>=1.25.0",
+    "sphinx-copybutton>=0.5.2",
+    "sphinx-rtd-theme>=2.0.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["rossum_mcp*"]
+
+
+
+[tool.coverage.run]
+omit = ["rossum_mcp/server.py"]
+
+[tool.pytest.ini_options]
+markers = [
+    "unit: marks tests as unit tests",
+    "integration: marks tests as integration tests (require API access)",
+]
+asyncio_mode = "auto"

rossum_mcp-1.0.1/rossum_mcp/__init__.py

@@ -0,0 +1,3 @@
+from __future__ import annotations
+
+__version__ = "1.0.1"

rossum_mcp-1.0.1/rossum_mcp/logging_config.py

@@ -0,0 +1,141 @@
+"""Shared logging configuration for Rossum MCP/Agent with Redis integration."""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+import sys
+from datetime import UTC, datetime
+from logging import LogRecord
+
+import redis
+
+
+class RedisHandler(logging.Handler):
+    """Custom logging handler that sends logs to Redis."""
+
+    def __init__(self, host: str, port: int = 6379, key_prefix: str = "logs", additional_fields: dict | None = None):
+        """Initialize Redis handler.
+
+        Args:
+            host: Redis host (e.g., "localhost")
+            port: Redis port (default: 6379)
+            key_prefix: Prefix for Redis keys
+            additional_fields: Additional fields to add to every log record
+        """
+        super().__init__()
+
+        self.client = redis.Redis(host=host, port=port, decode_responses=True)
+        self.key_prefix = key_prefix
+        self.additional_fields = additional_fields or {}
+
+    def emit(self, record: LogRecord) -> None:
+        """Emit a log record to Redis."""
+        if record.name.startswith("redis"):
+            return
+
+        try:
+            log_entry = {
+                "@timestamp": datetime.now(UTC).isoformat().replace("+00:00", "Z"),
+                "level": record.levelname,
+                "logger": record.name,
+                "message": record.getMessage(),
+                "module": record.module,
+                "function": record.funcName,
+                "line": record.lineno,
+                "thread": record.thread,
+                "thread_name": record.threadName,
+                **self.additional_fields,
+            }
+
+            for key, value in record.__dict__.items():
+                if key not in {
+                    "name",
+                    "msg",
+                    "args",
+                    "created",
+                    "filename",
+                    "funcName",
+                    "levelname",
+                    "levelno",
+                    "lineno",
+                    "module",
+                    "msecs",
+                    "message",
+                    "pathname",
+                    "process",
+                    "processName",
+                    "relativeCreated",
+                    "thread",
+                    "threadName",
+                    "exc_info",
+                    "exc_text",
+                    "stack_info",
+                    "taskName",
+                }:
+                    log_entry[key] = value
+
+            if record.exc_info:
+                log_entry["exception"] = self.format(record)
+
+            key = f"{self.key_prefix}:{datetime.now(UTC).strftime('%Y-%m-%d')}"
+            self.client.rpush(key, json.dumps(log_entry))
+            self.client.expire(key, 604800)  # 7 days
+        except Exception:
+            self.handleError(record)
+
+
+def setup_logging(
+    app_name: str = "rossum-app",
+    log_level: str = "DEBUG",
+    log_file: str | None = None,
+    use_console: bool = True,
+    redis_host: str | None = None,
+    redis_port: int | None = None,
+) -> logging.Logger:
+    """Configure logging with console, file, and optional Redis handlers.
+
+    Args:
+        app_name: Application name
+        log_level: Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
+        use_console: Whether to add console handler (default: True)
+        redis_host: Redis host (default: from REDIS_HOST env var)
+        redis_port: Redis port (default: 6379)
+
+    Returns:
+        Configured root logger
+    """
+    root_logger = logging.getLogger()
+    root_logger.setLevel(getattr(logging, log_level.upper()))
+    root_logger.handlers.clear()
+
+    formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
+
+    if use_console:
+        console = logging.StreamHandler(sys.stdout)
+        console.setFormatter(formatter)
+        root_logger.addHandler(console)
+
+    redis_host_val = redis_host or os.getenv("REDIS_HOST")
+    redis_port_val = redis_port or int(os.getenv("REDIS_PORT", "6379"))
+
+    if redis_host_val:
+        try:
+            redis_client = redis.Redis(host=redis_host_val, port=redis_port_val, socket_timeout=2)
+            redis_client.ping()
+
+            redis_handler = RedisHandler(
+                host=redis_host_val,
+                port=redis_port_val,
+                key_prefix="logs",
+                additional_fields={"application": app_name, "environment": os.getenv("ENVIRONMENT", "develop")},
+            )
+            redis_handler.client = redis_client
+            redis_handler.setLevel(logging.INFO)
+            root_logger.addHandler(redis_handler)
+            root_logger.info(f"Redis logging enabled: {redis_host_val}:{redis_port_val}")
+        except Exception as e:
+            root_logger.warning(f"Redis logging disabled: {e}")
+
+    return root_logger