healthcare-mcp-demo/
├── server.py               # FastMCP Server (Resources, Tools, Prompts, SSE transport)
├── client.py               # Deterministic host test script (Direct MCP protocol verification)
├── pydantic_llm_client.py  # AI Host script (Pydantic AI + Gemini + MCPToolset + Auth)
├── pyproject.toml          # Project dependencies managed by uv
├── uv.lock                 # Lockfile for precise dependency resolution
└── README.md               # Documentation


----

Prerequisites
Python: 3.10 or higher

Package Manager: uv installed on your system

API Key: Google Gemini API key (GEMINI_API_KEY)

Installation & Setup
Clone or navigate to the repository:

PowerShell
cd healthcare-mcp-demo
Install Dependencies:
uv will automatically set up the virtual environment and install all necessary packages:

PowerShell
uv sync
Configure Environment Variables:
Set your Gemini API key in your terminal session:

PowerShell
# Windows PowerShell
$env:GEMINI_API_KEY="your-actual-gemini-api-key"

# Linux / macOS
export GEMINI_API_KEY="your-actual-gemini-api-key"
Running the Application
Running the demo requires two terminal windows:

Step 1: Start the Remote MCP Server (Terminal 1)
Run the server script using uv:

PowerShell
uv run .\server.py
The server will start listening on http://0.0.0.0:8000/sse.

Step 2: Run the AI Host Client (Terminal 2)
In a second terminal, execute the Pydantic AI client script:

PowerShell
uv run .\pydantic_llm_client.py
Expected Output Workflow
The client establishes an authenticated SSE connection using a Bearer Token (secure-healthcare-secret-token-123).

Pydantic AI sends the user query alongside the discovered MCP tools to Gemini.

Gemini determines that update_patient_status needs to be called.

The MCP Tool executes on server.py, updating the record for patient P-101.

Gemini synthesizes the execution feedback and returns a natural language response:

Plaintext
User Request: 'Please update patient P-101's status to 'Discharged' and set condition to 'Acute Bronchitis - Fully Recovered'.'

Executing request via Gemini + FastMCP...

=== GEMINI RESPONSE ===
The patient record for P-101 has been successfully updated.

* Status: Discharged
* Condition: Acute Bronchitis - Fully Recovered