# MCP-HYDRATION

A proof of concept MCP server for tracking water intake, using `fastmcp` and managed with `uv`.

## Installation

This project was developed with `Python 3.13` and uses `uv` for dependency management.

**Install Dependencies:**. 
```bash
uv sync
```


## Running Locally

![MCP Demo](images/mcp-demo.gif)


### 1. Start the MCP Server

Run the server on `http://127.0.0.1:8000`.

```bash
uv run python main.py
```

### 2. Dev Inspector (Optional)
To interact with the running server using the dev inspector:

```Bash
uv run fastmcp dev main.py:mcp
```
The inspector will be available at http://localhost:6274.

![MCP Inspector Overview](images/mcp-inspector.png)


## Interacting with Claude Desktop
To use this server as a tool with the Claude Desktop application, configure a custom Model Control Protocol (MCP) server.

Configuration: Add the following JSON object to your Claude Desktop configuration:

```JSON
{
  "mcpServers": {
    "mcpHydrationServer": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "http://127.0.0.1:8000/mcp"
      ]
    }
  },
  "isUsingBuiltInNodeForMcp": true
}
```
Ensure the server is running locally (see step 1 above) before connecting with Claude Desktop.