adk-agent-extension

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ADK Agent Extension

ADK Agent 扩展

Overview

概述

Use

adk-agent-extension

as an MCP server that any MCP-capable agent client can connect to.

Use this for:

ADK discovery (
```
list_adks
```
,
```
list_adk_agents
```
)
ADK chat/session flow (
```
create_session
```
,
```
send_message_to_agent
```
, streaming/session helpers)
ADK helper operations (create/deploy/evaluate/list tools/safety/visualize)

将

adk-agent-extension

用作任何支持MCP的Agent客户端均可连接的MCP服务器。

可用于以下操作：

ADK发现（
```
list_adks
```
、
```
list_adk_agents
```
）
ADK聊天/会话流程（
```
create_session
```
、
```
send_message_to_agent
```
、流式传输/会话辅助工具）
ADK辅助操作（创建/部署/评估/列出工具、安全检查、可视化）

Workflow

工作流程

Build artifacts locally when needed:

bash

bun install
bun run build

command:
```
node
```

args:

["/absolute/path/to/adk-agent-extension/dist/google-adk-agent-extension.js"]

Reopen/reload the client and verify tools are visible.

Run ADK flow:

```
list_adks
```
```
list_adk_agents
```
```
create_session
```
```
send_message_to_agent
```

Use client-specific config examples from

references/client-configs.md

必要时在本地构建产物：

bash

bun install
bun run build

在目标客户端中注册标准输入输出（stdio）MCP服务器：
- 命令：
```
node
```
- 参数：
```
["/absolute/path/to/adk-agent-extension/dist/google-adk-agent-extension.js"]
```
重启或重载客户端，确认工具已显示。

执行ADK流程：

```
list_adks
```
```
list_adk_agents
```
```
create_session
```
```
send_message_to_agent
```

可参考

references/client-configs.md

中的客户端特定配置示例。

Gemini CLI Setup (Optional Client-Specific Shortcut)

Gemini CLI 配置（可选客户端快捷方式）

For Gemini CLI users, install directly:

bash

gemini extensions install https://github.com/simonliu-ai-product/adk-agent-extension

针对Gemini CLI用户，可直接安装：

bash

gemini extensions install https://github.com/simonliu-ai-product/adk-agent-extension

Bundled MCP Server

内置MCP服务器

The repo already defines MCP server wiring:

File:
```
gemini-extension.json
```
Key:
```
mcpServers.nodeServer
```
Command:
```
node
```

Entrypoint:

${extensionPath}/dist/google-adk-agent-extension.js

Implication:

In Gemini CLI extension mode, MCP registration is automatic on install.
In other clients, manually register equivalent stdio config.

本仓库已定义MCP服务器连接配置：

文件：
```
gemini-extension.json
```
键值：
```
mcpServers.nodeServer
```
命令：
```
node
```

入口文件：

${extensionPath}/dist/google-adk-agent-extension.js

说明：

在Gemini CLI扩展模式下，安装后会自动完成MCP注册。
在其他客户端中，需手动注册等效的标准输入输出（stdio）配置。

Portable Tool Surface (All MCP Clients)

跨客户端通用工具集（所有MCP客户端）

```
list_adks
```
```
list_adk_agents
```
```
create_session
```
```
send_message_to_agent
```
```
stream_message_to_agent
```
```
manage_chat_session
```
```
create_agent
```
```
deploy_agent
```
```
evaluate_agent
```
```
list_agent_tools
```
```
scan_agent_safety
```
```
visualize_agent_system
```

```
list_adks
```
```
list_adk_agents
```
```
create_session
```
```
send_message_to_agent
```
```
stream_message_to_agent
```
```
manage_chat_session
```
```
create_agent
```
```
deploy_agent
```
```
evaluate_agent
```
```
list_agent_tools
```
```
scan_agent_safety
```
```
visualize_agent_system
```

Gemini-Only Slash Commands

Gemini专属斜杠命令

```
/adk-ext:list_adks
```
```
/adk-ext:list_adk_agent
```
```
/adk-ext:agent_chat
```
```
/adk-ext:interactive_chat
```
```
/adk-ext:config_add_server
```
```
/adk-ext:config_list_servers
```
```
/adk-ext:config_remove_server
```
```
/adk-ext:create_agent
```
```
/adk-ext:deploy_agent
```
```
/adk-ext:evaluate_agent
```
```
/adk-ext:list_agent_tools
```
```
/adk-ext:scan_safety
```
```
/adk-ext:visualize
```

```
/adk-ext:list_adks
```
```
/adk-ext:list_adk_agent
```
```
/adk-ext:agent_chat
```
```
/adk-ext:interactive_chat
```
```
/adk-ext:config_add_server
```
```
/adk-ext:config_list_servers
```
```
/adk-ext:config_remove_server
```
```
/adk-ext:create_agent
```
```
/adk-ext:deploy_agent
```
```
/adk-ext:evaluate_agent
```
```
/adk-ext:list_agent_tools
```
```
/adk-ext:scan_safety
```
```
/adk-ext:visualize
```

Configuration

配置

Manage ADK server endpoints through

adk_agent_list.json

(extension root) or the config commands above.

Example:

json

{
  "agents": [
    { "name": "my-adk-server", "url": "https://my-adk-server.example.com" }
  ]
}

可通过扩展根目录下的

adk_agent_list.json

或上述配置命令管理ADK服务器端点。

示例：

json

{
  "agents": [
    { "name": "my-adk-server", "url": "https://my-adk-server.example.com" }
  ]
}

Troubleshooting

故障排查

If tools are missing, confirm your client is MCP-capable and loaded the stdio server config.
If MCP calls fail, ensure
```
dist/google-adk-agent-extension.js
```
exists and
```
node
```
is available.
If agent discovery fails, verify server URLs in
```
adk_agent_list.json
```
.
If command names differ by client UI, call tools directly from MCP tool picker by exact tool name.

若工具未显示，请确认你的客户端支持MCP且已加载标准输入输出（stdio）服务器配置。
若MCP调用失败，请确保
```
dist/google-adk-agent-extension.js
```
存在且
```
node
```
环境可用。
若Agent发现失败，请验证
```
adk_agent_list.json
```
中的服务器URL。
若客户端UI中命令名称不同，请通过MCP工具选择器直接按精确工具名称调用。

Resources

资源

references/

```
references/client-configs.md
```
: quick MCP client configuration snippets for Codex, Claude Code, Cursor, Cline, and Gemini CLI.

```
references/client-configs.md
```
：适用于Codex、Claude Code、Cursor、Cline和Gemini CLI的快速MCP客户端配置代码片段。

assets/

```
assets/mcp/adk-agent-extension.stdio.json
```
: reusable MCP stdio server template you can copy into client MCP settings.

```
assets/mcp/adk-agent-extension.stdio.json
```
：可复用的MCP标准输入输出（stdio）服务器模板，你可将其复制到客户端MCP设置中。