modular-calculator-mcp by JayvenKnight - MCP Server

Modular Calculator MCP Server

A Model Context Protocol (MCP) server providing personalized calculator applications with modular buttons tailored to different professions.

Features

🧮 Modular Calculator System - Customizable button layouts
👥 Professional Templates - Pre-configured for accountants, financial analysts, scientists, engineers
🐳 Docker Support - Containerized deployment
🧪 Comprehensive Testing - 10/10 tests passing
🌐 Web Interface - User-friendly web UI
🔧 MCP Protocol - Standardized tool execution

Quick Start

Local Development

# Setup virtual environment
python3 -m venv venv
source venv/bin/activate

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

# Run the server
python run.py

Docker Deployment

docker compose up -d

📍 Access the Application

Web Interface: http://localhost:8000/web
API Documentation: http://localhost:8000/docs
Health Check: http://localhost:8000/health

🛠️ API Usage

# Initialize user calculator
curl -X POST http://localhost:8000/api/initialize-calculator \
  -H "Content-Type: application/json" \
  -d '{"user_id": "user_001", "profession": "accountant"}'

# Execute calculation
curl -X POST http://localhost:8000/api/execute-calculation \
  -H "Content-Type: application/json" \
  -d '{"operation": "compound_interest", "inputs": {"principal": 1000, "rate": 0.05, "time": 10}}'

🧪 Testing

# Run all tests
python -m pytest tests/ -v

# Run tests in Docker
docker-compose run test

📁 Project Structure

modular-calculator-mcp/
├── src/                 # Source code
├── tests/               # Test suite
├── static/              # Web interface assets
├── docker/              # Docker configuration
├── pyproject.toml       # Dependencies and configuration
└── docker-compose.yml   # Multi-container setup

📊 Supported Operations

➕ Basic arithmetic (add, multiply, etc.)
💰 Financial calculations (compound interest, loan payments, ROI)
📊 Tax calculations and profit margins
📈 Statistical analysis
⚖️ BMI and health calculations

📄 License

MIT License