# Personal Digital Assistant MCP

A Personal Digital Assistant built with [FastMCP](https://gofastmcp.com), exposing a set of utility tools over the Model Context Protocol (MCP).

## Tools

| Tool | Description |
|---|---|
| `hello` | Return a friendly greeting for a given name. |
| `calculator` | Perform add, subtract, multiply, or divide on two numbers. |
| `current_time` | Return the current local date and time. |
| `generate_uuid` | Generate a random UUID (v4). |
| `generate_password` | Generate a secure random password of a given length. |
| `calculate_bmi` | Calculate Body Mass Index and category from weight/height. |
| `calculate_age` | Calculate age in years from a date of birth (`YYYY-MM-DD`). |
| `unit_converter` | Convert between units: `c_to_f`, `f_to_c`, `km_to_miles`, `miles_to_km`. |

## Requirements

- Python 3.13+

## Setup

```powershell
# Create and activate a virtual environment
python -m venv .venv
.\.venv\Scripts\Activate.ps1

# Install dependencies
pip install -r requirements.txt
```

## Usage

Start the MCP server:

```powershell
python server.py
```

Run the sample client (connects to the server and calls each tool):

```powershell
python client.py
```

Verify your environment/installation:

```powershell
python verify_installation.py
```