MCP Wygiwyh

🚀 WYGIWYH API MCP Server

A production-ready Model Context Protocol (MCP) server that offers a universal interface to the WYGIWYH expense tracking API. It enables AI agents and automation platforms like n8n to interact with the expense tracking system through standardized tool calls.

Original repo of WYGIWYH

✨ Features

• 🔄 Dynamic Tool Generation: Automatically generates 75 MCP tools from the OpenAPI specification.
• 🔐 Secure Authentication: Utilizes bearer token authentication for MCP endpoints and basic authentication for API access.
• 🚀 HTTP Streamable Transport: Fully compatible with n8n and other MCP clients.
• 🐳 Production-Ready Docker: Features an optimized multi - stage build with health checks.
• ⚡ Async/Await: Enables efficient non - blocking API communication.
• 📊 Comprehensive API Coverage: Exposes all WYGIWYH API endpoints as tools.

🎯 Use Cases

• Automate expense tracking workflows using n8n.
• Build AI assistants for managing financial data.
• Create custom integrations with the WYGIWYH API.
• Implement voice - controlled expense logging.
• Develop automated reporting systems.

📦 Installation

Prerequisites

• Docker & Docker Compose
• WYGIWYH API credentials
• MCP Bearer token

Steps

1. Clone the repository

   git clone https://github.com/ReNewator/MCP-WYGIWYH.git
   cd MCP-WYGIWYH
   

2. Configure environment

   cp .env.example .env
   # Edit .env with your credentials
   # Don't forget to change your WYGIWYH url in server.py
   

3. Deploy with Docker

   ./deploy.sh
   

   Or manually:

   docker-compose up -d
   

4. Verify deployment

   curl http://localhost:5000/health
   

💻 Usage Examples

Basic Usage

You can use the following command to check the server health:

curl http://localhost:5000/health

Advanced Usage

To list all available MCP tools with their schemas, use the tools/list method.

📚 Documentation

Configuration

Create a .env file with the following variables:

# WYGIWYH API Credentials
API_USERNAME=your_email@example.com
API_PASSWORD=your_password_here

# MCP Server Authentication
MCP_TOKEN=your_mcp_bearer_token_here

n8n Integration

Configure the n8n MCP Client node:

• Endpoint: http://your-server:5000/
• Transport: HTTP Streamable
• Authentication: Header Auth
  • Name: Authorization
  • Value: Bearer YOUR_MCP_TOKEN

Available Tools

The server exposes 75 MCP tools organized by category:

Project Structure

.
├── mcp_sse_server.py      # Main MCP server with HTTP Streamable
├── server.py              # Core MCP implementation
├── test_server.py         # Validation script
├── Dockerfile             # Production Docker image
├── docker-compose.yml     # Docker Compose config
├── deploy.sh              # Automated deployment
├── requirements.txt       # Python dependencies
├── DEPLOYMENT.md          # Detailed deployment guide
├── PROJECT.md             # Technical documentation
└── attached_assets/
    └── WYGIWYH API.yaml   # OpenAPI specification

Deployment

Docker (Recommended)

# Build and run
docker-compose up -d

# View logs
docker-compose logs -f

# Stop server
docker-compose down

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: wygiwyh-mcp-server
spec:
  replicas: 2
  template:
    spec:
      containers:
      - name: mcp-server
        image: wygiwyh-mcp-server:latest
        ports:
        - containerPort: 5000
        env:
        - name: API_USERNAME
          valueFrom:
            secretKeyRef:
              name: wygiwyh-secrets
              key: api-username

Cloud Platforms

• AWS ECS/Fargate: Use the Docker image with environment variables.
• Google Cloud Run: Deploy as a container with secrets management.
• Azure Container Instances: Direct deployment from Docker Hub.

See DEPLOYMENT.md for detailed cloud deployment instructions.

Testing

Run the validation script to verify the setup:

python test_server.py

This displays all 75 generated MCP tools grouped by category.

API Endpoints

• POST /: MCP JSON - RPC endpoint (requires bearer token).
• GET /health: Health check (no authentication).

🔧 Technical Details

Dynamic Tool Generation

The server automatically generates MCP tools from the OpenAPI specification:

1. Parses the WYGIWYH API OpenAPI YAML.
2. Converts schemas to JSON Schema format.
3. Creates Tool objects for all operations.
4. Handles allOf merging for complex types.
5. Exposes tools via the MCP protocol.

Benefits:

• Single source of truth (OpenAPI spec).
• Automatic updates when the API changes.
• Zero manual endpoint definitions.
• Consistent tool schemas.

Authentication Flow

┌─────────────┐     Bearer Token     ┌─────────────┐
│   n8n/MCP   │ ──────────────────> │  MCP Server │
│   Client    │                      │             │
└─────────────┘                      └─────────────┘
                                            │
                                            │ Basic Auth
                                            ▼
                                     ┌─────────────┐
                                     │  WYGIWYH    │
                                     │     API     │
                                     └─────────────┘

🐛 Troubleshooting

Server won't start

# Check logs
docker-compose logs

# Verify environment
cat .env

Authentication errors

• Ensure API_USERNAME is your WYGIWYH email.
• Verify API_PASSWORD is correct.
• Check MCP_TOKEN matches the client configuration.

Connection refused

# Check server status
docker-compose ps

# Test health endpoint
curl http://localhost:5000/health

📄 License

Copyright (c) 2025 ReNewator.com. All rights reserved.

🔗 Links

• WYGIWYH API Documentation
• Model Context Protocol
• n8n Automation

💬 Support

For issues and questions:

• Open an issue on GitHub.
• Check existing documentation.
• Review deployment logs.

Built with ❤️ by ReNewator.com