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:.

uv sync

Running Locally

1. Start the MCP Server

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

uv run python main.py

2. Dev Inspector (Optional)

To interact with the running server using the dev inspector:

uv run fastmcp dev main.py:mcp

The inspector will be available at http://localhost:6274.

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:

{
  "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.