Used for feedback · quests · score card
Install Docker, get API keys, clone the repo, and verify everything works before we start building.
Container runtime for all services
One Gemini key (free tier works)
Everything runs in containers. If you don't have Docker Desktop installed, download it from
docker.com and install it.
docker --version docker compose version
You should see version numbers for both. Docker Compose v2+ is required.
git clone https://github.com/your-org/mcp-workshop.git cd mcp-workshop/mcp-lab03
One key, and its free tier is plenty for a workshop.
Free at aistudio.google.com/apikey.
We call it through its OpenAI-compatible endpoint, so any
OpenAI-format key works too — the provider is bound in
.env and nowhere else.
It uses yr.no (api.met.no) for the
forecast and Nominatim for geocoding. Both are free and ask only for an honest
User-Agent — which is also the
most common reason the tool suddenly stops working.
cp .env.example .env
Edit .env and add your key:
OPENAI_API_KEY=your-gemini-api-key-here
make up
This pulls Docker images, builds the services, and starts everything. First run takes 2-3 minutes.
# Check all services are healthy make status # Test the MCP server make curl-list # Test the agent make curl-agent
You should see all services as "healthy" and get a response from the agent. If something's wrong,
check make logs for error details.
Success! Open http://localhost:8080 in your browser to see the chat interface.
Try asking about the weather!
Your feedback helps us improve the workshop.
Your handle is sent with this feedback; leave it blank in the header and the submission stays anonymous. Please keep personal data out of the comment too — no name, e-mail address or employer, yours or anyone else's.