# 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:

```bash
# 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:

```bash
# 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`):

```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