chore: import upstream snapshot with attribution

2026-07-13 13:25:13 +08:00
commit ec2b666284
2231 changed files with 491535 additions and 0 deletions
@@ -0,0 +1,74 @@
+# AgentTool with MCP Demo (Stdio Mode)
+
+This demo shows how `AgentTool` works with MCP (Model Context Protocol) toolsets using **stdio mode**.
+
+## Stdio vs SSE Mode
+
+This demo uses **stdio mode** where the MCP server runs as a subprocess:
+
+- **Simpler setup** - No need to start a separate server
+- **Auto-launched** - Server starts automatically when agent runs
+- **Local process** - Uses stdin/stdout for communication
+
+For the **SSE (remote server) version**, see [mcp_in_agent_tool_remote](../mcp_in_agent_tool_remote/).
+
+## Setup
+
+**No installation required!** The MCP server will be launched automatically using `uvx` when you run the agent.
+
+The demo uses `uvx` to fetch and run the MCP simple-tool server directly from the GitHub repository's subdirectory:
+
+```bash
+uvx --from 'git+https://github.com/modelcontextprotocol/python-sdk.git#subdirectory=examples/servers/simple-tool' \
+    mcp-simple-tool
+```
+
+This happens automatically via the stdio connection when the agent starts.
+
+## Running the Demo
+
+```bash
+adk web contributing/samples
+```
+
+Then select **mcp_in_agent_tool_stdio** from the list and interact with the agent.
+
+## Try These Prompts
+
+This demo uses **Gemini 2.5 Flash** as the model. Try these prompts:
+
+1. **Check available tools:**
+
+   ```
+   What tools do you have access to?
+   ```
+
+1. **Fetch and summarize JSON Schema specification:**
+
+   ```
+   Use the mcp_helper to fetch https://json-schema.org/specification and summarize the key features of JSON Schema
+   ```
+
+## Architecture
+
+```
+main_agent (root_agent)
+  │
+  └── AgentTool wrapping:
+        │
+        └── mcp_helper (sub_agent)
+              │
+              └── McpToolset (stdio connection)
+                    │
+                    └── MCP Server (subprocess via uvx)
+                          │
+                          └── uvx --from git+...#subdirectory=... mcp-simple-tool
+                                │
+                                └── Website Fetcher Tool
+```
+
+## Related
+
+- **Issue:** [#1112 - Using agent as tool outside of adk web doesn't exit cleanly](https://github.com/google/adk-python/issues/1112)
+- **Related Issue:** [#929 - LiteLLM giving error with OpenAI models and Grafana's MCP server](https://github.com/google/adk-python/issues/929)
+- **SSE Version:** [mcp_in_agent_tool_remote](../mcp_in_agent_tool_remote/) - Uses remote server connection
@@ -0,0 +1,15 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import agent
@@ -0,0 +1,75 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from google.adk.agents import Agent
+from google.adk.tools import AgentTool
+from google.adk.tools.mcp_tool import McpToolset
+from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
+from mcp import StdioServerParameters
+
+# Create MCP toolset
+# This uses the simple-tool MCP server via stdio
+# The server will be launched automatically using uvx from the subdirectory
+mcp_toolset = McpToolset(
+    connection_params=StdioConnectionParams(
+        server_params=StdioServerParameters(
+            command="uvx",
+            args=[
+                "--from",
+                "git+https://github.com/modelcontextprotocol/python-sdk.git#subdirectory=examples/servers/simple-tool",
+                "mcp-simple-tool",
+            ],
+        ),
+        timeout=10.0,
+    )
+)
+
+# Create sub-agent with MCP tools
+# This agent has direct access to MCP tools
+sub_agent = Agent(
+    name="mcp_helper",
+    description=(
+        "A helpful assistant with access to MCP tools for fetching websites."
+    ),
+    instruction="""You are a helpful assistant with access to MCP tools.
+
+When the user asks for help:
+1. Explain what tools you have available (website fetching)
+2. Use the appropriate tool if needed
+3. Provide clear and helpful responses
+
+You have access to a website fetcher tool via MCP. Use it to fetch and return website content.""",
+    tools=[mcp_toolset],
+)
+
+# Wrap sub-agent as an AgentTool
+# This allows the main agent to delegate tasks to the sub-agent
+# The sub-agent has access to MCP tools for fetching websites
+mcp_agent_tool = AgentTool(agent=sub_agent)
+
+# Create main agent
+# This agent can delegate to the sub-agent via AgentTool
+root_agent = Agent(
+    name="main_agent",
+    description="Main agent that can delegate to a sub-agent with MCP tools.",
+    instruction="""You are a helpful assistant. You have access to a sub-agent (mcp_helper)
+that has MCP tools for fetching websites.
+
+When the user asks for help:
+- If they need to fetch a website, call the mcp_helper tool
+- Otherwise, respond directly
+
+Always be helpful and explain what you're doing.""",
+    tools=[mcp_agent_tool],
+)