mcp-cli

一个轻量级、专为AI代理优化的MCP服务器命令行交互工具。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:mcp-cli。
它的用途是:一个轻量级、专为AI代理优化的MCP服务器命令行交互工具。
完整的 Skill 内容见:https://321skill.com/skills/mcp-cli/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'用 mcp-cli 调用 filesystem 服务器,读取当前目录下的 README.md 文件内容。',它会执行命令 `mcp-cli call filesystem read_file '{"path": "./README.md"}'` 并返回文件内容。或者你可以让AI先列出所有可用工具:'列出所有配置的MCP服务器和它们的工具'。

介绍

mcp-cli 是一个基于 Bun 构建的轻量级命令行工具,专门设计用于与遵循 MCP(模型上下文协议)的服务器进行交互。它解决了开发者和AI助手在调用不同MCP服务时,需要统一、便捷接口的需求。

使用上,你只需通过简单的配置文件(mcp_servers.json)定义需要连接的MCP服务器(如文件系统、GitHub、Deepwiki等),即可通过 mcp-cli 命令发现、搜索和调用服务器提供的各种工具(Tools)。它支持从标准输入读取JSON参数,并输出结构化的JSON结果,非常适合在Shell脚本或AI工作流中集成。

这个工具特别适合AI编码助手(如Claude Code、Gemini CLI等)、开发者以及希望将MCP服务器能力集成到自动化流程中的用户。它充当了AI代理与后端MCP服务之间的高效桥梁。

需要注意的是,其核心依赖 Bun 运行时。虽然可以通过编译生成单文件二进制,但初始安装或开发时需确保环境支持。此外,它主要是一个调用中介,本身不提供具体的AI能力,而是依赖于你配置的MCP服务器。

核心特点

与同类MCP客户端相比,mcp-cli专为AI代理和自动化场景优化,具备连接池和60秒空闲超时机制以保持连接温暖,提升连续调用速度;同时,它提供强大的工具过滤(Allow/Disable)和服务器指令显示功能,让AI能更精准、安全地使用后端服务。

注意事项

不适合需要复杂图形界面或非MCP协议后端服务直接交互的场景。

常见问题

mcp-cli 是什么?

一个用于连接和调用MCP(模型上下文协议)服务器的命令行工具。

一定要用Bun吗?

核心基于Bun,但可通过 bun build --compile 编译成独立的可执行文件,脱离Bun环境运行。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/mcp-cli/raw/index.md 读取 mcp-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。