Calculator MCP Server

A simple calculator server implementing the Model Context Protocol (MCP).

Features

This MCP server provides the following calculator operations:

• add: Add two numbers together

• subtract: Subtract second number from first

• multiply: Multiply two numbers

• divide: Divide first number by second (with zero-check)

• power: Raise a number to a power

• sqrt: Calculate square root

• percentage: Calculate percentage of a number

Installation

Using uv (recommended)

The easiest way is to use uvx which was just installed:

# Test the server directly
export PATH="$HOME/.local/bin:$PATH"
uvx --from . --with mcp calculator-mcp-server

Manual Installation with pip

If you prefer pip, install in a virtual environment:

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install dependencies
pip install git+https://github.com/modelcontextprotocol/python-sdk.git

# Run the server
python calculator_mcp_server.py

Configuration

Add this to your Kiro MCP configuration file (.kiro/settings/mcp.json):

{
  "mcpServers": {
    "calculator": {
      "command": "/Users/anshikagupta/.local/bin/uvx",
      "args": ["--from", "/Users/anshikagupta/calculator", "--with", "mcp", "python", "calculator_mcp_server.py"],
      "disabled": false,
      "autoApprove": ["add", "subtract", "multiply", "divide", "power", "sqrt", "percentage"]
    }
  }
}

Usage Examples

Once configured, you can use the calculator through Kiro:

• "Add 5 and 3"

• "What's 10 divided by 2?"

• "Calculate 2 to the power of 8"

• "What's the square root of 144?"

• "Calculate 20% of 500"

Tools Available

add

Add two numbers together.

• Parameters: a (number), b (number)

• Example: {"a": 5, "b": 3} → "5 + 3 = 8"

subtract

Subtract second number from first.

• Parameters: a (number), b (number)

• Example: {"a": 10, "b": 3} → "10 - 3 = 7"

multiply

Multiply two numbers.

• Parameters: a (number), b (number)

• Example: {"a": 4, "b": 5} → "4 × 5 = 20"

divide

Divide first number by second.

• Parameters: a (number), b (number)

• Example: {"a": 20, "b": 4} → "20 ÷ 4 = 5"

power

Raise base to exponent.

• Parameters: base (number), exponent (number)

• Example: {"base": 2, "exponent": 8} → "2^8 = 256"

sqrt

Calculate square root.

• Parameters: number (number, non-negative)

• Example: {"number": 144} → "√144 = 12"

percentage

Calculate percentage of a number.

• Parameters: number (number), percent (number)

• Example: {"number": 500, "percent": 20} → "20% of 500 = 100"

License

MIT