mcp-cli

mcp-cli 技能概览

mcp-cli 技能帮助你通过 mcp 命令行工具按需使用 MCP 服务器，这样你就能发现工具、资源和 prompts，而不必把某个 MCP 服务器永久接入到代理配置里。如果你想在正式集成前，先用一种轻量、可测试的方式探查服务器能力，这个技能会很有用。

mcp-cli 的用途

这个 mcp-cli skill 最适合需要快速访问 MCP 能力的 agent 和进阶用户，尤其适用于真正的任务是“看看这个服务器能做什么”，而不是“搭一个长期连接器”的场景。它适合工作流自动化、临时调试，以及那些上下文膨胀代价很高的短时任务。

什么时候适合使用

当你已经有 MCP 服务器命令、URL 或容器镜像，并且需要检查它暴露了什么能力时，就用 mcp-cli。它尤其适合一次性的文件系统、GitHub、memory 或基于 HTTP 的服务器，也适用于服务器在你的环境中尚未预配置的情况。

主要采用权衡

它最大的价值，是无需搭建成本就能完成发现；最大的限制，是你仍然需要可用的本地 mcp 二进制文件和有效的服务器命令。如果你想要的是完全托管、持久化的 MCP 集成，那么这个技能不是首选。

如何使用 mcp-cli 技能

安装 mcp-cli 并验证二进制文件

对于 mcp-cli install，仓库默认期望 mcp 二进制文件位于 ~/.local/bin/mcp。如果它不存在，先构建它，然后确保你的 PATH 包含 ~/.local/bin：

cd /tmp && git clone --depth 1 https://github.com/f/mcptools.git
cd mcptools && CGO_ENABLED=0 go build -o ~/.local/bin/mcp ./cmd/mcptools
export PATH="$HOME/.local/bin:$PATH"

如果二进制文件不在 PATH 里，技能会在开始任何发现动作之前就失败。

先从一个具体的服务器命令开始

mcp-cli usage 在你提供真实的服务器调用时效果最好，而不是给出一个模糊目标。好的输入会明确服务器名称以及运行方式，例如 npx -y @modelcontextprotocol/server-filesystem /path/to/allow、docker run ... ghcr.io/github/github-mcp-server，或一个 HTTPS 端点。这样技能才会变成可执行的操作，而不是停留在猜测层面。

按正确顺序执行发现

先让技能用 mcp tools <server-command> 枚举工具。如果服务器支持的不止工具，再继续使用 mcp resources <server-command> 和 mcp prompts <server-command>。这个顺序能让你在尝试调用任何东西之前，先知道可用项有哪些，这正是 mcp-cli for Workflow Automation 的核心优势。

优先阅读真正重要的仓库文件

在这个仓库里，先看 SKILL.md，因为它包含操作流程和前置条件。这里没有需要额外检查的 helper 文件夹，所以你不用花时间去找 rules/、resources/ 或 scripts/。这让阅读路径异常短，也减少了配置上的不确定性。

mcp-cli 技能 FAQ

mcp-cli 是普通 MCP 集成的替代品吗？

不是。mcp-cli 面向的是按需发现和执行，而不是构建永久性的集成层。如果你的工作流需要始终在线的服务器接线，普通集成会更合适。

使用这个技能需要是专家吗？

不需要，但你确实需要一个真实的服务器命令，以及对自己想检查什么有基本概念。只要能跟着 shell 命令执行，并在行动前先读懂发现出来的工具列表，初学者也可以顺利使用。

什么时候不该用 mcp-cli？

如果你还没安装 mcp 二进制文件、服务器命令未知，或者你只需要一个不必检查服务器的一次性简单 prompt，就跳过它。若你的目标是持久化、生产级编排，而不是发现能力，这个技能也不合适。

mcp-cli 和通用 prompt 有什么不同？

通用 prompt 可以解释 MCP 概念，但 mcp-cli 是围绕真实命令执行来设计的：列出工具、检查资源，然后选择调用路径。这个具体流程减少了猜测，也更容易验证服务器行为。

如何改进 mcp-cli 技能

给技能一个明确的服务器目标

最好的结果来自包含精确服务器类型、启动命令、认证需求，以及任何本地路径或环境变量的输入。例如，mcp tools npx -y @modelcontextprotocol/server-filesystem /Users/me/projects 就比“检查一下我的文件服务器”要好得多。

先说明任务，再给命令

告诉技能你是要发现能力、测试一个失败的服务器，还是自动化某个特定动作。这个上下文会影响 mcp-cli 是在发现后就停下，还是继续进入 resources 和 prompts。

留意常见失败模式

大多数问题都来自 PATH 没配好、服务器命令不完整，或者误以为每个服务器都支持 tools、resources 和 prompts。如果输出看起来很少，先检查服务器启动命令，而不是急着重写请求。

从发现推进到执行

先用第一轮了解服务器的能力范围，再把请求收窄到你接下来真正想要的那个工具或资源。通常这种“两步走”的循环，比要求 mcp-cli 一次性解决整个工作流效果更好。