mcp2cli-plugin
将MCP服务器工具转换为独立CLI脚本,优化Token消耗。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:mcp2cli-plugin。 它的用途是:将MCP服务器工具转换为独立CLI脚本,优化Token消耗。 完整的 Skill 内容见:https://321skill.com/skills/mcp2cli-plugin/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我把 chrome-devtools-mcp 这个MCP服务器转换成可以直接在终端里用的命令行工具。” 它会引导一个子代理进程,使用mcporter发现该服务器的所有功能(如截图、导航),并为每个功能生成一个独立的、带有`--help`说明的Node.js脚本。之后,你就可以在AI对话中直接让它执行`chrome-snapshot --selector ".content"`来捕获网页元素了。
介绍
mcp2cli是一个Claude Code插件,旨在解决MCP(Model Context Protocol)服务器在AI开发中带来的两大痛点。首先,MCP服务器的工具定义会直接加载到上下文窗口中,即使未被使用也会消耗大量Token,导致上下文窗口臃肿,影响AI处理效率。其次,通过mcporter等工具直接调用MCP命令语法复杂冗长,AI代理难以主动且可靠地使用它们。
该插件通过一个简单的命令(如/mcp2cli chrome-devtools-mcp),引导Claude生成一个子代理。这个子代理会利用mcporter发现指定MCP服务器的所有工具,并为每个工具自动生成一个独立的、具有完整--help文档支持的Node.js CLI脚本。这些脚本会被放置在~/agent-tools/目录下,并创建符号链接到系统PATH(如~/.local/bin),使得AI和用户都能像使用普通Bash命令一样直接调用。
它非常适合智能体开发、全栈开发和运维工程师等角色。这些开发者经常需要让AI代理与各种MCP工具(如浏览器调试、文件系统操作、数据抓取等)进行交互,但受限于上下文长度和命令的复杂性。mcp2cli通过将工具“本地化”和“标准化”,极大地提升了AI代理使用外部工具的主动性和可靠性。
使用前请确保已安装Node.js 18+和mcporter(npx mcporter可用)。生成的工具脚本是纯JavaScript,可根据需要进行二次修改。注意,这是一个“仅提示”插件,本身不包含可执行代码,其核心是指导Claude完成转换工作流。
核心特点
与直接使用mcporter相比,mcp2cli将每个MCP工具生成为独立的、自带`--help`的CLI脚本并符号链接到PATH,使AI代理能像调用原生Bash命令一样可靠使用;与在Claude Code中直接加载MCP服务器相比,它避免了工具定义预加载导致的无谓Token消耗,仅在调用`--help`时才加载相关文档。
注意事项
不适合需要MCP服务器实时流式响应或复杂状态管理的场景,因为转换后的CLI工具是独立调用的。
常见问题
这个插件需要安装额外的运行时吗?
需要。必须提前安装Node.js 18+和mcporter(确保`npx mcporter`命令可用),这是插件生成工具的基础。
生成的CLI工具在哪里?如何调用?
工具生成在`~/agent-tools/<服务器名>/`目录,并自动符号链接到`~/agent-tools/bin`或`~/.local/bin`。你可以直接在终端或AI对话中通过脚本名(如`chrome-snapshot`)调用,无需输入完整路径。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/mcp2cli-plugin/raw/index.md 读取 mcp2cli-plugin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/mcp2cli-plugin/raw/index.md(查看排版版本)