{"id":30092863,"url":"https://github.com/jonico/octocat-harry-potter-agent","last_synced_at":"2025-08-09T08:44:35.980Z","repository":{"id":302271892,"uuid":"1011295177","full_name":"jonico/octocat-harry-potter-agent","owner":"jonico","description":"Agent based on fast.agent showing how to use the Harry Potter Octocat MCP server and Adcanced Postman MCP server","archived":false,"fork":false,"pushed_at":"2025-07-06T14:39:28.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-08T10:44:22.994Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonico.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-30T15:40:29.000Z","updated_at":"2025-07-06T14:40:51.000Z","dependencies_parsed_at":"2025-07-01T19:45:35.868Z","dependency_job_id":null,"html_url":"https://github.com/jonico/octocat-harry-potter-agent","commit_stats":null,"previous_names":["jonico/octocat-harry-potter-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jonico/octocat-harry-potter-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonico%2Foctocat-harry-potter-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonico%2Foctocat-harry-potter-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonico%2Foctocat-harry-potter-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonico%2Foctocat-harry-potter-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonico","download_url":"https://codeload.github.com/jonico/octocat-harry-potter-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonico%2Foctocat-harry-potter-agent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269553409,"owners_count":24437167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-09T08:44:35.235Z","updated_at":"2025-08-09T08:44:35.948Z","avatar_url":"https://github.com/jonico.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Harry Potter / Octocats Example Agent\n\n[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/).\n\n## Workshop slides:\nhttps://drive.google.com/drive/folders/1CQaKkrcuD8Vxam559EEdCByX0z2s-Oxc?usp=sharing\n\n\u003cimg width=\"1791\" alt=\"image\" src=\"https://github.com/user-attachments/assets/9279d543-27d4-4fde-a9aa-60ff3aa3e532\" /\u003e\n\n\n## Getting Started\n\n### Prerequisites\n- Python 3.10+\n- [`uv`](https://github.com/astral-sh/uv) (recommended for fast Python package management)\n\n\n### Installation\n1. Clone this repository or copy the files to your local machine.\n2. Install the `fast-agent-mcp` package using `uv`:\n\n```bash\n# create and activate a python environment\nuv venv\nsource .venv/bin/activate\n# install the fast-agent-mcp package\nuv pip install fast-agent-mcp\n```\n\n\n### Configuration\nBefore 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.\n\n\n### Running the Example\n\nRun the agent using `uv` (recommended):\n\n```bash\nuv run harry-potter-octocat.py --model  openai.gpt-4o\n```\n\nOr start an interactive session with fast-agent and point to any MCP server:\n\n```bash\nuv run fast-agent go --url http://localhost:9000/sse --model sonnet35\n```\n\n### Example output\n\n# Harry Potter Characters Meet Octocats 🧙‍♂️🐱\n\n## 1. Harry Potter - Heroic Octocat\n| Harry Potter | Sentrytocat |\n|--------------|--------------|\n| \u003cimg src=\"https://ik.imagekit.io/hpapi/harry.jpg\" alt=\"Harry Potter\" width=\"100\" height=\"100\"\u003e | \u003cimg src=\"https://octodex.github.com/images/Sentrytocat_octodex.jpg\" alt=\"Heroic Octocat\" width=\"100\" height=\"100\"\u003e |\n- **Traits Matched**: Brave, protective, stands against adversity\n- **Octocat Reasoning**: The Sentrytocat embodies Harry's guardianship and courage\n\n## 2. Hermione Granger - Professortocat\n| Hermione Granger | Professortocat |\n|------------------|----------------|\n| \u003cimg src=\"https://ik.imagekit.io/hpapi/hermione.jpeg\" alt=\"Hermione Granger\" width=\"100\" height=\"100\"\u003e | \u003cimg src=\"https://octodex.github.com/images/Professortocat_v2.png\" alt=\"Professortocat\" width=\"100\" height=\"100\"\u003e |\n- **Traits Matched**: Intelligent, studious, always prepared\n- **Octocat Reasoning**: Reflects Hermione's academic brilliance and love of learning\n\n## 3. Ron Weasley - Welcometocat\n| Ron Weasley | Welcometocat |\n|-------------|--------------|\n| \u003cimg src=\"https://ik.imagekit.io/hpapi/ron.jpg\" alt=\"Ron Weasley\" width=\"100\" height=\"100\"\u003e | \u003cimg src=\"https://octodex.github.com/images/welcometocat.png\" alt=\"Welcometocat\" width=\"100\" height=\"100\"\u003e |\n- **Traits Matched**: Loyal, friendly, warm-hearted\n- **Octocat Reasoning**: Represents Ron's welcoming nature and importance of friendship\n\n## 4. Draco Malfoy - Stormtroopocat\n| Draco Malfoy | Stormtroopocat |\n|--------------|----------------|\n| \u003cimg src=\"https://ik.imagekit.io/hpapi/draco.jpg\" alt=\"Draco Malfoy\" width=\"100\" height=\"100\"\u003e | \u003cimg src=\"https://octodex.github.com/images/stormtroopocat.png\" alt=\"Stormtroopocat\" width=\"100\" height=\"100\"\u003e |\n- **Traits Matched**: Stern, uniformed, follows a strict code\n- **Octocat Reasoning**: Symbolizes Draco's rigid upbringing and conformity to Slytherin expectations\n\n## 5. Minerva McGonagall - Justicetocat\n| Minerva McGonagall | Justicetocat |\n|--------------------|--------------|\n| \u003cimg src=\"https://ik.imagekit.io/hpapi/mcgonagall.jpg\" alt=\"Minerva McGonagall\" width=\"100\" height=\"100\"\u003e | \u003cimg src=\"https://octodex.github.com/images/justicetocat.jpg\" alt=\"Justicetocat\" width=\"100\" height=\"100\"\u003e |\n- **Traits Matched**: Disciplined, fair, protective of students\n- **Octocat Reasoning**: Embodies McGonagall's strong sense of justice and principled leadership\n\n*Magical matches brought to you by the intersection of wizardry and git magic! 🧙‍♀️🐱*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonico%2Foctocat-harry-potter-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonico%2Foctocat-harry-potter-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonico%2Foctocat-harry-potter-agent/lists"}