Agent Skills
返回列表
🤖

pctx Code Mode 统一 MCP 代理工具调用

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/run-agent-tool-calls-through-pctx-code-mode-and-unified-mcp 技能。

技能介绍

当代理工具调用开始「散架」

实际开发中，AI 代理的工具调用常陷入两种困境：一是 MCP 服务器与自定义工具分散管理，调用逻辑要么散落在各模块的「一次性代码」里，要么依赖隐式配置；二是代码执行层与工具调用脱节，想统一管理工具暴露范围、权限边界时，缺少集中式的约束点——比如给代理开放文件读取权限时，很容易顺手给了过宽的网络访问权限。

pctx 如何把工具调用收进代码执行层

这个技能的核心是用 pctx Code Mode 和统一 MCP 作为代理与工具之间的边界层，替代零散的工具调用逻辑。具体工作路径很明确：

  • 先明确列出需要接入的 MCP 服务器，避免代理误连无关服务；
  • 用 Code Mode 统一接管工具调用，所有 MCP 工具与自定义工具都通过代码导向的执行层运行，而不是每次单独写调用逻辑；
  • 主动审查通过 Code Mode 暴露的工具，确保代理能调用的工具范围与工作流需求匹配；
  • 严格控制边界层的权限，文件系统、网络等访问权限不超过当前工作流的实际需要。

适用边界与注意点

  • 仅适用于已集成 pctx CLI、Python SDK 或 npm 包的项目，且代理栈需兼容 MCP 客户端或 OpenAI Agents SDK；
  • 不适合纯文本交互、无需工具调用的场景，强行引入会增加不必要的复杂度；
  • 不要为了「省事」给 pctx 边界层开放过宽权限，比如仅需要读取本地配置文件时，不要允许网络访问；
  • MCP 服务器列表和工具暴露范围需定期 review，避免工作流变更后遗留无关工具或权限。

使用场景

  • 代理需要调用多个MCP服务器与自定义工具时，用pctx Code Mode统一接管调用，避免逻辑散落。
  • 团队需要限制代理工具调用的权限范围时，通过边界层配置，控制文件系统和网络访问不超过工作流需求。
  • 代理工作流变更后，需要确保工具暴露范围合理时，定期审查Code Mode暴露的工具列表，移除无关工具。
  • Python代理需要通过HTTP服务调用pctx时，集成Python客户端，让代理工具调用走统一执行层。

适合人员

  • 构建Python代理的开发者，希望用Python客户端统一管理代理的工具调用，避免重复写调用逻辑。
  • 负责代理权限治理的工程师，需要集中控制代理工具的暴露范围和边界层权限。
  • 使用Node.js或Homebrew环境的开发者，希望通过本地命令快速搭建pctx Code Mode或MCP配置。
  • 集成OpenAI Agents SDK的团队，想让代理通过MCP兼容客户端调用工具，同时保持代码执行层的一致性。