# Demo FastMCP Server (Python)

This repository is a minimal MCP server demo built with FastMCP.

## What is included

- `main.py`: FastMCP server with three demo tools
- `pyproject.toml`: project metadata and dependencies
- `.gitignore`: basic Python ignores

## Demo tools

- `ping`: returns `pong`
- `add_numbers(a, b)`: returns the sum of two numbers
- `get_utc_time()`: returns the current UTC time

## Quick start (uv)

1. Install uv: https://docs.astral.sh/uv/getting-started/installation/
2. Create and sync environment:

   ```powershell
   uv venv
   uv sync
   ```

3. Run the server:

   ```powershell
   uv run fastmcp run main.py:mcp --transport http --port 8000
   ```

4. MCP endpoint:

   - `http://127.0.0.1:8000/mcp`

## Quick start (pip)

```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
fastmcp run main.py:mcp --transport http --port 8000
```

## Try from an MCP client

Ask your MCP client to run these tool calls:

- `ping`
- `add_numbers` with `a=5` and `b=7`
- `get_utc_time`