# 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]"

# 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

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

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

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

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

# Run all tests
pytest

# Run with coverage
pytest --cov=src

# Run specific test file
pytest tests/test_remittance_server.py

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