能否支持按需关闭 MCP 工具名的 <server>_ 前缀？

[sfsflm]

大家好，先谢谢 DeerFlow 团队和各位贡献者，这个项目我一直在用，受益良多。

我有一个小小的使用诉求，想来听听大家的意见，水平有限，如果有理解不对的地方也请指正。

我在项目里接入了学术类的 MCP server（semantic-scholar）。

{
  "mcpServers": {
    "semantic-scholar": {
      "command": "uvx",
      "args": ["s2-mcp-server"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your-key-here"
      }
    }
  }
}

发现它返回的工具名自带 server 标识的名字，比如 semantic_scholar_search_papers。

而 DeerFlow 在加载 MCP 工具时，会统一给每个工具名加上 <server>_ 前缀，于是最终模型看到的工具名就成了：

semantic-scholar_semantic_scholar_search_papers

前缀本身我觉得很有必要，主要是为了避免多个 server 之间工具重名。但对于这种 server 自身命名已经比较唯一的情况，两层名字叠在一起会显得有点冗余。

所以我的想法是：能不能提供一个开关，让我们可以针对单个 server 选择是否保留这个前缀？默认还是保持现在的行为（加前缀），只是给像我这样遇到"名字已经自带 server 标识"的场景，多一个不加重前缀的选项。

再次说明，这纯粹是我个人的使用体验，可能社区里有更好的处理思路（比如有没有现成的配置就能缓解？），如果已经有相关方案也欢迎指路。谢谢大家。

[willem-bd]

结论：目前不支持。 DeerFlow 给 MCP 工具名加 <server>_ 前缀是硬编码的，既没有 per-server 开关，也没有全局开关。

根因（带代码位置）：

• 前缀来自 langchain-mcp-adapters 的 MultiServerMCPClient，DeerFlow 加载时写死了 tool_name_prefix=True：backend/packages/harness/deerflow/mcp/tools.py:643。
• 这个标志是整个 client 级别的一个 bool，并不是 per-server 的（见库 langchain_mcp_adapters/client.py:57，get_tools() 内部对每个 server 都用同一个 self.tool_name_prefix）。所以即便想按 server 开关，库本身也没有入口，得绕过它。
• DeerFlow 的 per-server 配置 McpServerConfig（backend/packages/harness/deerflow/config/extensions_config.py:75-93）目前只有 enabled / type / command / args / env / url / headers / oauth / description / routing / tools / tool_call_timeout，没有前缀相关字段。

一个要澄清的点：双重名字不全是 DeerFlow 的锅。 semantic_scholar_search_papers 是 s2-mcp-server 自己给工具加的 semantic_scholar_ 前缀；DeerFlow 又在你的 server key semantic-scholar 上加了 semantic-scholar_，于是变成 semantic-scholar_semantic_scholar_search_papers。两层各来自一边。

现在就能用的缓解（不改代码）： 在 extensions_config.json 里把 server key 改短。DeerFlow 加的前缀是 <key>_，而 key 就是你在 mcpServers 里写的那个名字。把 "semantic-scholar" 改成比如 "s2"，工具名就变成 s2_semantic_scholar_search_papers——DeerFlow 那层冗余消掉了，但 server 自己的 semantic_scholar_ 还在。不算彻底，但最省事、零风险。

这个需求合理、也可实现，改动量不大。 大致三处：

1. 在 McpServerConfig 加个字段，如 tool_name_prefix: bool = True（默认保持现状）。
2. 加载时按 server 传这个值。因为 MultiServerMCPClient 只收全局 bool，最干净的做法是绕过它、对每个 server 直接调 load_mcp_tools(..., tool_name_prefix=per_server)——DeerFlow 现在本来就是 per-server get_tools(server_name=...)，结构上好改。
3. 调整 session-pool 判定：mcp/tools.py:692 现在用 tool.name.startswith(f"{source_name}_") 来决定是否给 stdio 工具套持久会话。关掉前缀后该条件为假，会丢掉会话池复用（对 Playwright 这类有状态 server 有影响；对 semantic-scholar 这种无状态的无所谓）。需要把判定从"看前缀"改成"看 stdio transport + 开关"。

好在其余用到前缀的地方都已经 graceful 了：mcp/tools.py:687-688 恢复原名、:444-446 在 session-pool tool 里 strip 前缀，都有 if startswith 守卫，没前缀时是 no-op；routing 配置查找用的是 original name；deferred tool 目录按模型可见名匹配，自洽。所以真正要小心改的就是第 3 点。

没搜到已有相关 issue/PR，属于新需求。如果维护者觉得方向 OK，我可以提个 PR。