https://github.com/jonico/octocat-harry-potter-agent
Agent based on fast.agent showing how to use the Harry Potter Octocat MCP server and Adcanced Postman MCP server
https://github.com/jonico/octocat-harry-potter-agent
Last synced: 11 months ago
JSON representation
Agent based on fast.agent showing how to use the Harry Potter Octocat MCP server and Adcanced Postman MCP server
- Host: GitHub
- URL: https://github.com/jonico/octocat-harry-potter-agent
- Owner: jonico
- Created: 2025-06-30T15:40:29.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-06T14:39:28.000Z (about 1 year ago)
- Last Synced: 2025-08-08T10:44:22.994Z (11 months ago)
- Language: Python
- Homepage:
- Size: 17.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Harry Potter / Octocats Example Agent
[fast-agent](https://fast-agent.ai) based example agent to connect to the [Octocat Harry Potter MCP server](https://github.com/jonico/octocat-harry-potter-mcp-server) and [advanced MCP server](https://github.com/jonico/typescript-anthropic-tool-use-example/).
## Workshop slides:
https://drive.google.com/drive/folders/1CQaKkrcuD8Vxam559EEdCByX0z2s-Oxc?usp=sharing
## Getting Started
### Prerequisites
- Python 3.10+
- [`uv`](https://github.com/astral-sh/uv) (recommended for fast Python package management)
### Installation
1. Clone this repository or copy the files to your local machine.
2. Install the `fast-agent-mcp` package using `uv`:
```bash
# create and activate a python environment
uv venv
source .venv/bin/activate
# install the fast-agent-mcp package
uv pip install fast-agent-mcp
```
### Configuration
Before running the example, you need to adjust the Octocat HP MCP server settings in the `fastagent.config.yaml` file. Make sure the server address and credentials match your local or remote MCP server setup. Furthermore, you would need to set API keys for the model you are using in the `fastagent.secrets.yaml` file. You can use the example file `fastagent.secrets.yaml.example` as a template.
### Running the Example
Run the agent using `uv` (recommended):
```bash
uv run harry-potter-octocat.py --model openai.gpt-4o
```
Or start an interactive session with fast-agent and point to any MCP server:
```bash
uv run fast-agent go --url http://localhost:9000/sse --model sonnet35
```
### Example output
# Harry Potter Characters Meet Octocats 🧙♂️🐱
## 1. Harry Potter - Heroic Octocat
| Harry Potter | Sentrytocat |
|--------------|--------------|
| 
| 
|
- **Traits Matched**: Brave, protective, stands against adversity
- **Octocat Reasoning**: The Sentrytocat embodies Harry's guardianship and courage
## 2. Hermione Granger - Professortocat
| Hermione Granger | Professortocat |
|------------------|----------------|
| 
| 
|
- **Traits Matched**: Intelligent, studious, always prepared
- **Octocat Reasoning**: Reflects Hermione's academic brilliance and love of learning
## 3. Ron Weasley - Welcometocat
| Ron Weasley | Welcometocat |
|-------------|--------------|
| 
| 
|
- **Traits Matched**: Loyal, friendly, warm-hearted
- **Octocat Reasoning**: Represents Ron's welcoming nature and importance of friendship
## 4. Draco Malfoy - Stormtroopocat
| Draco Malfoy | Stormtroopocat |
|--------------|----------------|
| 
| 
|
- **Traits Matched**: Stern, uniformed, follows a strict code
- **Octocat Reasoning**: Symbolizes Draco's rigid upbringing and conformity to Slytherin expectations
## 5. Minerva McGonagall - Justicetocat
| Minerva McGonagall | Justicetocat |
|--------------------|--------------|
| 
| 
|
- **Traits Matched**: Disciplined, fair, protective of students
- **Octocat Reasoning**: Embodies McGonagall's strong sense of justice and principled leadership
*Magical matches brought to you by the intersection of wizardry and git magic! 🧙♀️🐱*