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:

Manual Installation with pip

If you prefer pip, install in a virtual environment:

Configuration

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

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