# Quick Start Guide
This is a quick reference guide. For detailed instructions, see [README.md](README.md).
## 30-Second Setup (assuming Python is installed)
```powershell
# Windows PowerShell
pip install uv
uv venv
.\.venv\Scripts\Activate.ps1
uv pip install "mcp[cli]"
python calculator_server.py
```
```bash
# macOS/Linux
pip3 install uv
uv venv
source .venv/bin/activate
uv pip install "mcp[cli]"
python calculator_server.py
```
## What Each Step Does
1. **`pip install uv`** - Install the uv package manager
2. **`uv venv`** - Create a virtual environment in `.venv/`
3. **Activate** - Start using the virtual environment
4. **`uv pip install "mcp[cli]"`** - Install MCP SDK with CLI tools
5. **`python calculator_server.py`** - Run the server
## Testing the Server
In a new terminal (with virtual environment activated):
```bash
npx -y @modelcontextprotocol/inspector
```
Then use the web UI to test the calculator tools.
## Available Tools
- `add(a, b)` - Add two numbers
- `subtract(a, b)` - Subtract two numbers
- `multiply(a, b)` - Multiply two numbers
- `divide(a, b)` - Divide two numbers (errors on divide by zero)
## Common Commands
```bash
# Activate virtual environment
# Windows:
.\.venv\Scripts\Activate.ps1
# macOS/Linux:
source .venv/bin/activate
# Deactivate virtual environment
deactivate
# Check MCP is installed
mcp --version
# Run the server
python calculator_server.py
# Check Python version
python --version
# List installed packages
uv pip list
```
## Troubleshooting
**"mcp command not found"**
- Make sure virtual environment is activated (prompt should show `(.venv)`)
**"Python not found"**
- Install Python from [python.org](https://www.python.org/downloads/)
- On Windows, check "Add Python to PATH" during installation
**"Module not found"**
- Make sure virtual environment is activated
- Run: `uv pip install "mcp[cli]"`
For more help, see [README.md#troubleshooting](README.md#troubleshooting).
