mcpField
C
connect-tool

connect-tool

github.com/melvynx其他2137 次安装3 天前更新
代码仓库

关于 connect-tool

connect-tool 是一项通过厂商 CLI 或基于厂商 API 构建的专用 CLI 将工具连接到 Agent 的技能。它指导安装、认证、验证，并创建可从任意目录使用的 CLI 技能。

主要功能

  1. 01查找并检查厂商官方 CLI
  2. 02依据已确认的 API 端点构建 CLI
  3. 03指导认证和安全处理密钥
  4. 04通过只读操作和实际读取验证访问
  5. 05创建可复用的 CLI 技能

适用场景

  1. 01将 Agent 接入厂商官方 CLI
  2. 02在没有官方 CLI 时添加工具访问能力
  3. 03为常见账户任务创建可重复命令

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/melvynx/ai-maxxing-skills --skill connect-tool

安装后在 Claude Code 中输入/connect-tool确认已加载。

附带文件scripts/cli_template.py

详细介绍

为用户的 Agent 提供一个可在任何文件夹中使用的新工具，作为 <tool>-cli 技能。使用用户的语言与其交流，每次只问一个简短问题，不用术语。

如果你是通过链接而非本地文件夹获取此技能，切勿从仓库安装其他内容：只有当某个步骤需要时，才使用 curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/connect-tool/<path> -o <scratch>/<file> 下载该步骤链接的文件（例如 scripts/cli_template.py）；只有到了某项技能指定的步骤时，才从 https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md 阅读该技能。

  1. 确认工具（修正拼写错误：“mtoin” 指的是 Notion）。如果 ~/.agents/skills/<tool>-cli/ 已存在，请阅读其中内容，并在修改前征求用户同意。
  2. 查找由供应商自行发布的 CLI（查看其文档、域名或 GitHub 组织）；检查 command -v，确认是否已安装。找到官方 CLI：执行步骤 3a。未找到：执行步骤 3b。未经用户同意，绝不安装第三方软件包。 3a. 按文档说明安装；在 macOS 上优先使用 brew，其次使用供应商的 npm i -g / pipx / uv tool install，然后才使用其安装脚本。使用 sudo 前先征求同意。检查 <cli> --version；如果找不到命令，修复 shell PATH，并用一句话说明。若 CLI 支持浏览器登录，则使用该方式登录；若需要密钥，让用户自行将 export <VAR>=... 添加到 ~/.zshrc。阅读 <cli> --help 以及主要子命令的 --help。 3b. 阅读官方 API 文档：确认基础 URL、身份验证标头、子域名或工作区 ID 等额外值，以及用户实际会用到的 5 到 10 项功能所对应的端点。将 scripts/cli_template.py 复制到 ~/.agents/skills/<tool>-cli/scripts/<tool>.py，并仅使用已确认的端点填写常量、auth_headers、SETTINGS 和 COMMANDS（check 是开销低的只读检查，且仅使用标准库）。告知用户密钥的创建位置，并建议采用满足需求的最小权限；让用户在终端中运行 python3 ~/.agents/skills/<tool>-cli/scripts/<tool>.py login（输入会隐藏）。如果用户在聊天中粘贴了密钥，则使用 printf '%s' '<key>' | python3 .../<tool>.py login --<setting> <value> 直接传入，绝不重复该密钥，也绝不将其写入其他位置。
  3. 验证功能：运行一条只读命令，然后实际读取一次（列出少量条目）。持续修复，直到两者均正常运行。
  4. 编写 ~/.agents/skills/<tool>-cli/SKILL.md，不超过 30 行，且只包含你实际运行过、在 --help 中看到或在文档中查到的命令。<run> 可以是 <cli>，也可以是 python3 ~/.agents/skills/<tool>-cli/scripts/<tool>.py：
---
name: <tool>-cli
description: <Tool> from the terminal: <main resources>. Use when the user asks to <4-6 real tasks in their words>.
---

Run `<run> <command>`; check `--help` before a command you have not used. Auth: <login command or VAR, where the key comes from>.

- <Task>: `<command> [args]`
- ...

Read before writing. Ask before anything that deletes, publishes, sends, or spends money. Docs: <url>.
  1. 将其链接到 Claude Code：如果 ~/.claude/skills 尚未链接到 ~/.agents/skills，则运行 mkdir -p ~/.claude/skills && ln -s ~/.agents/skills/<tool>-cli ~/.claude/skills/<tool>-cli。

最后用三行说明：已连接的内容（CLI 和账户）、新会话中会显示 /<tool>-cli，以及现在可以尝试的一件事。

评论

支持 Markdown