[Bug]同名的MCP工具会冲突

[iMoonway]

What happened / 发生了什么

在使用GrokSearch这个MCP的时候，工具列表里面有一个web_search工具，而在管理行为界面，自带的web_search和MCP的web_search无法同时启用。同时禁用自带的astrbot-web-searcher插件也会导致MCP里的web_search无法启用。

Reproduce / 如何复现？

安装GrokSearch MCP

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/GuDaStudio/GrokSearch",
    "grok-search"
  ],
  "env": {
    "GROK_API_URL": "url",
    "GROK_API_KEY": "key",
  }
}

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

Windows Docker Desktop, Moonshot/Kimi-k2.5,lark(飞书)

OS

Windows

Logs / 报错日志

复现管理行为面板

PixPin_2026-03-02_22-31-21.mp4

---

在人格管理界面，两个web_search工具被归并为一个

启用了7个工具

计数6个

---

AI的回复

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot]

感谢反馈这个 Bug！这是一个已知的架构限制问题。

问题根因：ToolSet.add_tool() 方法仅使用工具名称作为唯一标识符，当添加同名工具时会直接覆盖而非共存：

def add_tool(self, tool: FunctionTool) -> None:
    for i, existing_tool in enumerate(self.tools):
        if existing_tool.name == tool.name:
            self.tools[i] = tool  # 直接替换同名工具
            return
    self.tools.append(tool)

虽然系统通过 handler_module_path 属性区分 MCP 工具和插件工具，但这个区分在 ToolSet 层面没有被用于去重逻辑。

可能的修复方向：

• 使用 (origin_type, origin_name, name) 作为工具唯一键，而非仅用 name
• 为 MCP 工具设置特殊路径标识，如 handler_module_path = f"mcp:{mcp_server_name}"

临时解决方法：目前只能禁用其中一个同名工具，或者使用不同名称的 MCP 服务。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}