# mcp-math

Exact arithmetic and verification tools for math competitions.

## Purpose

Provides helpers for solving math problems with:
- Exact arithmetic (fractions, bigints, SymPy)
- Verification checks (integer, mod, range)
- Notebook-exportable code

## Design

The core is **pure Python** that works in Jupyter notebooks. The MCP server is a thin wrapper for local development.

```
mcp-math/
├── src/
│   ├── core/           # Pure Python helpers (notebook-compatible)
│   │   ├── exact.py    # Exact arithmetic functions
│   │   └── verify.py   # Verification functions
│   ├── server.py       # MCP server wrapper
│   └── export.py       # Export helpers for notebooks
└── tests/
```

## Usage

### In Claude Code (via MCP)
```
mikey_math_exact expr="1/3 + 1/4"
mikey_math_verify value=42 check="integer"
mikey_math_export  # Get notebook-ready code
```

### In Jupyter Notebook
```python
# Copy from export or paste directly
from fractions import Fraction
from sympy import *

def exact_eval(expr):
    """Evaluate expression with exact arithmetic."""
    ...
```

## Installation

```bash
cd ~/Code/mcp-math
python3 -m venv .venv
source .venv/bin/activate
pip install sympy mcp
```

Add to `~/.claude.json`:
```json
"mcp-math": {
  "command": "/Users/YOUR_USERNAME/Code/mcp-math/.venv/bin/python3",
  "args": ["/Users/YOUR_USERNAME/Code/mcp-math/src/server.py"]
}
```