apify/mcpc

The most compatible MCP CLI client. Supports: tools, resources, prompts, completions, async tasks, skills, stdio and streamable HTTP (MCP 2026-07-28 and 2025-11-25), persistent sessions, OAuth 2.1 with DCR, CIMD, client credentials, and ID-JAG, OS keychain, --json for code mode, grep for tool discovery, proxy for AI sandboxes, x402, and more.

什么是 mcpc?

mcpc 是一个命令行客户端,可让您与实现 模型上下文协议 (Model Context Protocol, MCP) 的任何服务器进行通信——这是 AI 智能体用于调用工具、获取资源、运行任务等的标准 API。它将每个 MCP 操作转换为简单的 shell 命令,因此您可以:

手动检查和调试 MCP 服务器。
使用普通 Bash 管道和 jq 等工具编写复杂的 MCP 工作流脚本。
为 AI 智能体提供单个 Bash() 工具,该工具可以访问任何 MCP 服务器,为智能体处理身份验证、会话和支付。

简而言之,它是一个通用的“MCP 到 shell”桥接器。

主要功能(如 README 中所述)

功能	含义
完整的 MCP 支持	实现整个 MCP 规范——工具、提示、资源、异步任务、技能、通知、日志记录,以及有状态和无状态协议版本。
持久会话	您可以同时保持多个命名连接,即使底层服务器是无状态的。
渐进式工具发现	`mcpc grep` 可以动态搜索服务器的工具目录,让智能体只需加载实际需要的工具(节省 token)。
代码模式 / JSON 输出	`--json` 使每个命令发出单个 JSON 对象,非常适合通过管道传递给 `jq`、`xargs` 或其他 shell 实用程序。
安全的 OAuth 2.1	内置客户端凭据流,凭据存储在操作系统钥匙串中(或在无头系统上存储在受保护的文件中)。
AI 沙盒	一种代理模式,可保护存储的凭据免受 AI 智能体生成的代码的影响。
轻量级	依赖项最少,适用于 macOS、Windows 和 Linux,本身不引入任何 LLM。
代理支付 (x402)	对 x402 支付协议(Base 平台使用)的实验性支持。

谁可能使用它?

用例	mcpc 如何提供帮助
AI 智能体开发者	智能体无需编写数十个 MCP 包装器,只需从其 Bash 工具调用 `mcpc` 即可获得完整的 MCP 功能(工具调用、资源读取、任务管理等)。
DevOps / 调试	检查服务器功能(`mcpc @session tools-list`)、测试工具调用,或直接从终端重放工作流。
自动化 / 脚本编写	将 `mcpc` 与标准 Unix 工具(`jq`、`xargs`、`awk`)结合使用,构建与 MCP 服务器交互的可重复管道。
安全意识强的团队	凭据存储在操作系统钥匙串中;沙盒模式可防止 AI 生成的代码泄露凭据。
支付集成	使用实验性的 x402 命令将支付钱包附加到需要它的 MCP 调用。

工作原理(高级流程)

登录 – mcpc login <server> 执行 OAuth 2.1 客户端凭据握手,并安全地保存令牌。
连接 – mcpc connect <server> @name 创建一个命名会话(例如 @apify)。客户端协商 MCP 版本,并保持一个轻量级桥接进程。
运行命令 – 在任何命令前加上会话名称,例如 mcpc @apify tools-call search-actors query:="web crawler"。参数可以作为 key:=value 对、JSON 块或通过 stdin 传递。
脚本 / 管道 – 添加 --json 以获得纯 JSON 输出,然后通过管道传递给 jq 或其他 shell 实用程序。
会话管理 – 会话可以列出(mcpc)、重新启动、关闭或清理(mcpc clean)。桥接器会在网络故障时自动重新连接,并刷新 OAuth 令牌。

安装

Homebrew (macOS/Linux): brew install mcpc
npm / Bun: npm install -g @apify/mcpc 或 bun install -g @apify/mcpc
在 Linux 上,凭据存储在桌面密钥服务中;在无头 CI 上,它会回退到 0600 权限的文件(~/.mcpc/credentials.json)。

快速入门示例

# 列出会话/配置文件
mcpc

# 登录到远程 MCP 服务器
mcpc login mcp.apify.com

# 创建名为 @test 的持久会话
mcpc connect mcp.apify.com @test

# 显示服务器功能
mcpc @test

# 列出可用工具
mcpc @test tools-list

# 调用工具(用于脚本编写的 JSON 输出)
mcpc --json @test tools-call search-actors keywords:="website crawler"

文档与进一步阅读

完整命令参考:mcpc --help(或生成的 REFERENCE.md)。
MCP 规范:https://modelcontextprotocol.io/specification/latest
安全说明:README 解释了配置文件自动发现如何避免泄露机密。
相关工作:存储库中的比较图表显示了 mcpc 与其他 MCP CLI 客户端的比较。

总结: 如果您需要一种可靠、可编写脚本的方式,让人类或 AI 智能体与 MCP 服务器交互——处理身份验证、会话、工具发现,甚至支付——mcpc 提供了一个轻量级、对 Unix 友好的包装器,无需引入重量级 AI 库即可完成所有这些工作。