feat: Add GitHub Wizard Agent

README.md

@@ -54,6 +54,10 @@ For production or clean local environments, use Docker.
 - **Tools**: Add functions to `agents/<your_agent>/tools/`
 - **Main Logic**: Edit `agents/<your_agent>/agent.py`
 
+## Available Agents
+
+- **GitHub Wizard** (`agents/github_wizard`): An agent equipped with GitHub MCP tools to assist with repository tasks. Requires `GITHUB_TOKEN`.
+
 ## Why not `adk web --session_service_uri ...`?
 
 ADK’s CLI defaults to local SQLite session storage unless you pass

agents/github_wizard/README.md

@@ -0,0 +1,23 @@
+# GitHub Wizard Agent
+
+The **GitHub Wizard** is a specialized agent designed to assist with GitHub-related tasks using the Model Context Protocol (MCP).
+
+## Features
+
+- **GitHub Integration**: Connects to GitHub using the GitHub Copilot MCP server.
+- **Task Assistance**: Helps answer questions and perform actions related to GitHub repositories, issues, and pull requests.
+
+## Configuration
+
+To use this agent, you must provide a valid GitHub token.
+
+1.  Obtain a GitHub Personal Access Token (PAT) with appropriate permissions.
+2.  Set the `GITHUB_TOKEN` environment variable in your `.env` file or environment.
+
+```env
+GITHUB_TOKEN=your_github_token_here
+```
+
+## Tools
+
+- **GitHub MCP Tools**: Automatically loaded if `GITHUB_TOKEN` is present.

agents/github_wizard/agent.py

@@ -0,0 +1,23 @@
+import os
+from google.adk.agents.llm_agent import Agent
+from google.adk.models.lite_llm import LiteLlm
+
+# Import tools
+from .tools.github_mcp import github_mcp_tools
+
+api_base_url = "https://openrouter.ai/api/v1"
+
+root_agent = Agent(
+    model=LiteLlm(
+        model="openrouter/openai/gpt-oss-120b",
+        api_base=api_base_url,
+        api_key=os.getenv("OPENROUTER_API_KEY"),
+    ),
+    name="github_wizard",
+    description="A helpful assistant for GitHub related tasks.",
+    instruction="""
+    Answer user questions to the best of your knowledge using the provided GitHub tools.
+    """,
+    # Give the agent tools to do its job
+    tools=github_mcp_tools,
+)

agents/github_wizard/tools/github_mcp.py

@@ -0,0 +1,20 @@
+import os
+from google.adk.tools.mcp_tool.mcp_toolset import McpToolset, StreamableHTTPConnectionParams
+
+def _get_github_mcp_tools():
+    github_token = os.getenv("GITHUB_TOKEN")
+    tools = []
+    if github_token:
+        tools = [
+            McpToolset(
+                connection_params=StreamableHTTPConnectionParams(
+                    url="https://api.githubcopilot.com/mcp/",
+                    headers={"Authorization": f"Bearer {github_token}"}
+                )
+            )
+        ]
+    else:
+        print("Warning: GITHUB_TOKEN not found. GitHub MCP tools will not be available.")
+    return tools
+
+github_mcp_tools = _get_github_mcp_tools()