Skip to content

valkryhx/google_adk_agent / skills/param_mcp

参数 MCP 工具集成专家

Verified

集成参数 Model Context Protocol (MCP) 工具,通过 HTTP 连接与外部参数 MCP 服务交互,提供参数管理、工单生成等功能。

FileKindSize
SKILL.mdskill md7.4 KB
tools.pyscript3.3 KB
---
name: "参数 MCP 工具集成专家"
description: "集成参数 Model Context Protocol (MCP) 工具,通过 HTTP 连接与外部参数 MCP 服务交互,提供参数管理、工单生成等功能。"
---

# Execution Instructions

## 基本说明

参数 MCP (Model Context Protocol) 工具集成技能,允许智能体通过 HTTP 协议连接到外部参数 MCP 服务,并使用服务提供的工具。

## 使用前提

1. **MCP 服务运行**: 确保 MCP 服务已启动并运行在配置的 URL 上(默认:`http://localhost:9014/mcp`)
2. **服务可用性**: 在加载此技能前,系统会尝试连接 MCP 服务,如果服务不可用,将使用占位工具

## 可用工具(精确参数签名)

加载此技能后,MCP 服务提供的所有工具将自动注册到智能体工具列表。以下是核心工具的精确签名,其他工具请参考 MCP 服务文档:

### tool_param_modify_draft(生成参数修改草稿)

```
tool_param_modify_draft(
    cgi: str,                   # 网元 CGI 标识,如 "460-00-2303087-1"
    unclear_param: str,         # 参数模糊名称,如 "4-5迟滞"(支持中文模糊匹配)
    param_group_id_value: str,  # 参数组 ID 值,如 "M10"
    new_value: str              # 新的参数值,如 "-11"
) -> dict
```

### tool_param_create_order(生成完整参数工单)

```
tool_param_create_order(
    city: str,                  # 所属地市,如 "大同"
    vendor: str,                # 设备厂商,如 "华为"
    net_type: str,              # 网络类型,如 "NR" 或 "LTE"
    param_level: str,           # 参数级别,如 "小区级"
    ne_name: str,               # 网元名称/CGI,如 "460-00-2303087-1"
    param_object: str,          # 参数对象,如 "NRCELLINTERFHOMEAGRP"
    param_name: str,            # 参数英文名称,如 "InterFreqA4A5TimeToTrig"
    param_group_id_name: str,   # 参数组 ID 名称,无则填 "无"
    param_group_id_value: str,  # 参数组 ID 值,如 "M10"
    new_value: str,             # 参数修改值,如 "-11"
    current_value: str,         # 现网参数值(可为空字符串)
    start_time: str,            # 开始时间,格式 "YYYY-MM-DD HH:MM:SS"
    end_time: str               # 结束时间,格式 "YYYY-MM-DD HH:MM:SS"
) -> dict
```

### tool_query_order_history(查询工单参数修改记录)

```
tool_query_order_history(
    order_id: str               # 工单 ID,如 "HN-HN-20251222-1627"
) -> dict
```

> **参数命名注意**:`tool_param_modify_draft` 使用 `cgi` 和 `unclear_param`,
> 而 `tool_param_create_order` 使用 `ne_name` 和 `param_name`(精确英文名)。
> 两者语义不同,注意区分,**切勿混用**。

## 使用流程

1. **加载技能**: 调用 `skill_load("param_mcp")` 加载参数 MCP 集成技能
2. **自动发现工具**: ADK 会自动识别 MCP 服务提供的所有工具,并将它们添加到工具列表
3. **使用工具**: 根据用户需求,直接调用相应的 MCP 工具

**重要提示**: 无需手动查询可用工具列表,ADK 框架会自动处理工具发现和注册。

## 配置

MCP 服务的 URL 可以通过环境变量 `MCP_URL` 配置,默认值为 `http://localhost:9014/mcp`。

## 错误处理

- 如果 MCP 服务不可用,将使用占位工具,返回友好的错误提示(含 URL 和排查步骤)
- 工具调用失败时,会返回详细的错误信息
- **初始化失败后不会重复尝试**,避免每次調用都產生連接超时

## Windows 环境注意事项

在 Windows 控制台或脚本中调用 MCP 工具时,务必设置 UTF-8 编码,否则中文参数可能导致**静默失败(无输出)**:

```bat
cmd /c set PYTHONIOENCODING=utf-8 && python your_script.py
```

或在 Python 脚本开头添加:

```python
import sys, io
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
```

## 注意事项

1. **服务依赖**: 此技能依赖于外部 MCP 服务,确保服务正常运行
2. **网络连接**: 确保能够访问 MCP 服务的 URL
3. **工具命名**: MCP 工具的名称由服务定义,可能与本地工具名称冲突(系统会自动处理)

## 示例

### 示例 1: 查询工单参数修改记录

**用户问题**: "查看工单 HN-HN-20251222-1627 的参数修改记录"

**执行流程**:
```
1. 加载技能: skill_load("param_mcp")
2. ADK 自动发现并注册 MCP 工具到智能体工具列表
3. 调用工具:
   tool_query_order_history(order_id="HN-HN-20251222-1627")
4. 返回结果: 显示工单的参数修改记录
```

### 示例 2: 生成参数修改草稿

**用户问题**: "生成参数修改草稿: 460-00-538402-107 参数组为M10 4-5迟滞修改为-11"

**执行流程**:
```
1. 确保技能已加载 (如果未加载,先调用 skill_load("param_mcp"))
2. 调用 MCP 草稿生成工具,传入参数信息(注意参数名称):
   tool_param_modify_draft(
       cgi="460-00-538402-107",         # 网元 CGI
       unclear_param="4-5迟滞",          # 模糊参数名,支持中文
       param_group_id_value="M10",       # 参数组
       new_value="-11"                   # 新值
   )
3. 返回生成的草稿内容,包含匹配到的精确参数名、网元信息等
```

### 示例 3: 生成完整工单(结合时间工具)

**用户问题**: "生成参数修改工单,设备 460-00-538402-107,城市娄底,厂商华为,LTE网络,小区级参数,参数对象CELLSEL,参数名QRxLevMin,参数组N10,新值-110,开始时间2025年12月24号12点23分"

**执行流程**:
```
1. 确保技能已加载
2. 如果需要当前时间或时间计算,先调用时间工具(如 get_current_time)
3. 调用 MCP 工单生成工具:
   tool_param_create_order(
       city="娄底",
       vendor="华为",
       net_type="LTE",
       param_level="小区级",
       ne_name="460-00-538402-107",
       param_object="CELLSEL",
       param_name="QRxLevMin",           # 精确英文参数名
       param_group_id_name="无",
       param_group_id_value="N10",
       new_value="-110",
       current_value="",
       start_time="2025-12-24 12:23:00",
       end_time=""                       # 如需要可通过时间工具计算
   )
4. 返回生成的工单信息
```

### 示例 4: 查询工单并获取当前时间

**用户问题**: "查看工单 HN-HN-20251222-1627 的参数修改记录,并告诉我当前时间"

**执行流程**:
```
1. 加载技能: skill_load("param_mcp")
2. 并行调用两个工具:
   - tool_query_order_history(order_id="HN-HN-20251222-1627")
   - get_current_time()
3. 整合两个工具的结果,返回给用户
```

## 工具发现说明

**ADK 自动工具发现机制**:
- 当 `McpToolset` 对象被添加到智能体的工具列表时,ADK 框架会自动调用 `get_tools()` 方法
- ADK 会解析每个工具的名称、描述、参数定义等信息
- 这些信息会自动提供给 LLM,智能体可以根据工具描述智能选择和使用工具
- **无需手动查询工具列表**,智能体可以直接根据用户需求调用相应的工具

**工具使用建议**:
- 查看 `## 可用工具(精确参数签名)` 章节了解准确的参数名称
- 根据用户问题的语义,选择最合适的工具
- 草稿生成(`tool_param_modify_draft`)和工单生成(`tool_param_create_order`)参数名不同,注意区分
- 可以组合使用多个工具来完成复杂任务
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall