MCP Server Workshop

Setup

Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate

Use python3 if needed. On Windows: .\.venv\Scripts\Activate

Install dependencies:

pip install -r requirements.txt

Test with MCP Inspector

Launch Inspector:

npx @modelcontextprotocol/inspector python server.py

Inspector opens at http://localhost:5173

Test the tools:

1. Run ping → returns {"ok": true, "message": "Server is running"}
2. Run weather with a city name (e.g., "London")

Troubleshooting

If Inspector gets stuck:

# macOS/Linux
pkill -f "@modelcontextprotocol/inspector"

# Windows
Get-Process | Where-Object { $_.Path -like "*@modelcontextprotocol*" } | Stop-Process