First Setup EMI Calculator

MCP EMI Calculator Server

Lightweight MCP server that exposes loan EMI calculation endpoints to MCP clients (for example, Claude Desktop).

Features

• STDIO-based FastMCP server that proxies to the REST backend

• Simple HTTP helper with JSON responses and 10 second timeout

• Configurable backend base URL via environment variables

Prerequisites

• Python 3.10+

• uv for environment management (pip-compatible)

Install uv if you do not already have it:

• macOS/Linux:

  curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows (PowerShell):

  powershell -ExecutionPolicy Bypass -Command "iwr -useb https://astral.sh/uv/install.ps1 | iex"

Quickstart (uv workflow)

1. Clone or download this repository.

2. From the project root, create a virtual environment (stored in .venv by default):

   uv venv

3. Activate the environment:

   source .venv/bin/activate      # macOS/Linux
   .venv\Scripts\Activate.ps1     # Windows (PowerShell)

4. Install dependencies:

   uv pip install -r requirements.txt

5. Create a .env file (if you do not already have one) with the backend base URL:

   EMI_API_BASE_URL=http://localhost:8000/api

6. Run the MCP server (communicates via STDIO):

   uv run python emi_calculator.py

MCP Client Registration (Claude Desktop example)

Add to your claude_desktop_config.json:

 "emiMcpServer": {
      "command": "uv",
      "args": [
        "--directory",
        "mcp_emi_server project path",
        "run",
        "emi_calculator.py"
      ]
    },

Configuration (.env)

• EMI_API_BASE_URL — base URL of the backend EMI APIs (default: http://localhost:8000/api)

Tools exposed

• calculate_emi — {principal, interestRate, tenure, calculation_method?} → EMI summary

• calculate_schedule — {principal, interestRate, tenure, calculation_method?} → amortization schedule

• compare_loans — {scenarios: [{name, principal, interestRate, tenure, calculation_method?}, ...]} → side-by-side comparison

• calculate_with_prepayment — {principal, interestRate, tenure, prepayment_amount, prepayment_frequency, prepayment_start_month, calculation_method?} → EMI with recurring prepayments

Troubleshooting

• Ensure the backend EMI API is running and reachable.

• Check stderr logs for detailed errors.