Business Automation MCP Servers

Multi-tool MCP server repository for business automation using FastMCP and Python.

Overview

This repository contains multiple MCP servers for business process automation:

1. RemittanceAdviceGen Server

Generates realistic remittance advice PDFs for testing purposes with configurable templates and comprehensive payment details.

Features:

• Generate single or batch remittance PDFs
• Realistic test data with suppliers, invoices, and payments
• Support for payment adjustments (surcharges, credits, discounts, fees)
• Configurable invoice line items
• Multiple page sizes (Letter, A4)
• Professional PDF formatting

2. APPaymentAnalyser Server (Coming Soon)

Tools for analyzing accounts payable payments, GL posting status, and payment analytics.

Installation

# Clone repository
git clone <repo-url>
cd CustomMCPServer

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e ".[dev]"

Usage

Running RemittanceAdviceGen Server

# STDIO mode (for Claude Desktop integration)
python -m src.remittance_server.server

# HTTP mode (for network access)
fastmcp run src/remittance_server/server.py --transport http --port 8000

Available Tools

generate_remittance_pdf

Generate a single remittance advice PDF with realistic test data.

{
    "invoice_count": 3,
    "include_line_items": true,
    "page_size": "LETTER",
    "include_adjustments": true
}

batch_generate_pdfs

Generate multiple remittance PDFs in batch.

{
    "count": 10,
    "invoices_per_remittance": 3,
    "include_line_items": true
}

list_templates

List available remittance templates.

get_server_info

Get server information and statistics.

Configuration

Create a .env file in the project root:

DEBUG=false
SERVER_PORT=8000
DEFAULT_PAGE_SIZE=LETTER
DEFAULT_TEMPLATE=standard
INCLUDE_LINE_ITEMS=true

Project Structure

CustomMCPServer/
├── src/
│   ├── common/                    # Shared utilities
│   │   ├── models.py             # Pydantic models
│   │   ├── database.py           # Database utilities
│   │   ├── config.py             # Configuration
│   │   └── test_data.py          # Test data generation
│   ├── remittance_server/        # Remittance advice server
│   │   ├── server.py             # FastMCP server
│   │   └── pdf_generator.py     # PDF generation engine
│   └── payment_analyser/         # Payment analyser server (coming soon)
├── tests/                         # Test suite
├── templates/                     # PDF templates
├── output/                        # Generated PDFs
├── data/                          # Database files
├── pyproject.toml                # Dependencies
└── README.md

Testing

# Run all tests
pytest

# Run with coverage
pytest --cov=src

# Run specific test file
pytest tests/test_remittance_server.py

Claude Desktop Integration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "remittance-advice": {
      "command": "python",
      "args": ["-m", "src.remittance_server.server"],
      "cwd": "/path/to/CustomMCPServer"
    }
  }
}

Development

Adding New Servers

1. Create new directory under src/
2. Implement FastMCP server with tools
3. Use shared models from src/common/
4. Add tests in tests/
5. Update documentation

Data Models

All servers share common Pydantic models in src/common/models.py:

• PaymentDetail: Payment information with adjustments
• Invoice: Invoice details with line items
• Supplier: Vendor information
• Company: Paying company information
• RemittanceAdvice: Complete remittance document

License

MIT License - See LICENSE file for details.