← 返回目录

Mcpc

社区

非标准 Server

通用 MCP 命令行客户端

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 38 / 438
Stars: ★ 1.0k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Bun · 预编译二进制
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 2 天前
工具数: 29

66FMRS · C

mcpc 是一个功能全面的 MCP CLI 客户端，支持丰富的 MCP 特性，适合开发者和 AI 代理使用。其安全功能（如 OAuth、代理）和 JSON 输出使其在脚本化和自动化中表现出色。然而，x402 和技能支持仍处于实验阶段，且不支持 Roots 和 Sampling。总体而言，它是一个强大且灵活的工具，但需要用户注意安全风险和实验性功能的不稳定性。

最强项 · 文档质量 20/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

14/20

文档质量

20/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 该仓库是一个针对MCP协议的CLI客户端，而非典型的MCP服务器。初始化握手和工具列表路径在README中有明确描述，并且持续集成（CI）工作流和测试目录（test/）提供了执行证据。然而，由于这是静态审查，未执行实际代码，且其功能广泛（多个传输、协议版本、认证方式），因此将评分限制在8分。
安全与权限 14/20: 项目将安全性作为核心亮点，包括对x402支付的OAuth 2.1支持、代理模式（遮蔽令牌）、文件权限0600以及安全的凭据存储（操作系统钥匙串）。它遵循最小权限原则，并为危险操作提供用户明确同意。没有发现恶意代码或明显越权。虽然未观察到由人确认的破坏性操作，但CLI工具本质上会暴露本地文件系统。
维护活跃度 14/20: 该仓库活跃，有7位以上贡献者、定期发布（npm版本和最新提交）、持续集成（CI）以及包含测试的测试目录。其许可证为Apache-2.0，清晰且宽松。没有发现明显的维护缺口。
文档质量 20/20: 文档极为全面，涵盖安装、快速入门、所有命令的详细说明、认证流程、配置以及故障排查（如错误和日志部分）。它是一个分层文档，包含示例、安全说明和限制说明（如x402实验性、任务限制）。令人印象深刻的文档质量为20分。
安装易用性 10/20: 安装通过npm或Homebrew进行，提供了清晰的说明。作为一个命令行工具，它需要Node.js或Bun，并为主流客户端提供了配置示例。由于未执行安装验证，且路径涉及外部依赖（Homebrew、npm），因此得分上限为10分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

希望通过 CLI 与 MCP 服务器交互的开发者和 AI 代理
想要脚本化 MCP 操作或集成到 CI/CD 的用户
需要在沙箱中安全暴露 MCP 凭据的用户

不适合谁

需要图形界面的用户
需要内置 LLM 调用的用户（mcpc 不直接使用 LLM）
需要 Roots 或 Sampling 支持的用户（mcpc 不支持）

所需权限

访问本地文件系统（用于配置和会话文件）
网络访问以连接远程 MCP 服务器
操作系统密钥链存储凭据
在 AI 沙箱场景中可能需要代理访问

风险与副作用

MCP 服务器可能执行任意命令或访问本地资源，需使用可信服务器
代理功能可能暴露本地服务，需谨慎配置绑定地址
x402 支付涉及加密货币交易，存在资金风险
OAuth 凭据存储在密钥链中，需保护系统安全

安装接入

准备工作

运行环境：Node.js · Bun · 预编译二进制

其他可选配置项（6 个）

MCPC_HOME_DIR 可选指定 mcpc 保存会话与认证配置的目录（默认 ~/.mcpc），非必需。

MCPC_VERBOSE 可选设为 1/true/yes 时启用详细调试日志。

MCPC_JSON 可选设为 1/true/yes 时默认启用 JSON 输出。

HTTPS_PROXY 可选出站 HTTPS 连接使用的代理 URL，优先级高于 HTTP_PROXY。

HTTP_PROXY 可选出站 HTTP 连接使用的代理 URL。

NO_PROXY 可选逗号分隔的不走代理的主机列表。

使用 Homebrew (macOS/Linux) 安装：brew install apify/tap/mcpc；或使用 npm 全局安装：npm install -g @apify/mcpc（需先安装 Node.js 或 Bun）。

验证是否装好

安装后运行 `mcpc --version` 和 `mcpc --help` 确认 CLI 可用，再执行 `mcpc connect mcp.apify.com @test` 和 `mcpc @test tools-list`，若能看到服务器工具列表即证明安装与连接正常。

常见排障

检查会话状态：运行 mcpc 或 mcpc --json 查看活动会话和状态
如果会话未授权，使用 mcpc login <server> 重新登录并重启会话
如果 stdio 服务器启动失败，查看 ~/.mcpc/logs/bridge-<session>.log 获取错误信息
确保环境变量如 HTTPS_PROXY 或 SSL_CERT_FILE 已正确设置（stdio 服务器仅继承最小环境）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前所有活跃的 mcpc 会话和已保存的认证配置。
连接到 mcp.apify.com 并列出可用的工具。
在 @apify 会话中搜索与 search 相关的工具。
调用 @apify 的 search-actors 工具，关键词为 website crawler。

工具能力 29

connect 写入

连接到一个 MCP 服务器并启动一个新的命名会话

close 写入

关闭一个会话

restart 写入

重启一个会话（丢失所有状态）

登录服务器并保存 OAuth 配置

logout 写入

删除服务器的 OAuth 配置

clean 破坏性

清理 mcpc 数据（会话、配置、日志、全部）

grep 只读

在所有活动会话中搜索工具和指示

x402 写入

配置 x402 支付钱包（实验性）

展开其余 21 个工具

help 只读

显示命令帮助

tools-list 只读

列出所有服务器工具

tools-get 只读

获取工具详情和模式

tools-call 写入

调用工具并传递参数

tasks-list 只读

列出活动任务

tasks-get 只读

检查任务状态

tasks-result 只读

获取任务结果（阻塞直到终止状态）

tasks-cancel 写入

取消运行中的任务

prompts-list 只读

列出可用提示词

prompts-get 只读

获取提示词模板

resources-list 只读

列出可用资源

resources-read 只读

读取资源内容

resources-subscribe 写入

订阅资源变化并同步到本地文件

resources-unsubscribe 写入

取消订阅资源

resources-templates-list 只读

列出资源模板

skills-list 只读

列出服务器暴露的技能（实验性）

skills-get 只读

读取技能的 SKILL.md

logging-set-level 写入

设置服务器日志级别（已弃用）

ping 只读

发送 ping 检查连接

server-discover 只读

发送 server/discover 请求（2026-07-28 协议）

logs 只读

查看会话桥接日志

使用场景

手动检查和调试 MCP 服务器

在 shell 脚本中自动化重复的 MCP 工作流

为 AI 代理提供完整的 MCP 协议访问

在多个会话中搜索工具以进行渐进式发现

支持客户端

Claude Desktop部分支持

Claude Code部分支持

依据项目文档列出，未经本站实测。

详细介绍

mcpc 是一个用于 Model Context Protocol (MCP) 的命令行客户端，将每个 MCP 操作映射为直观的 shell 命令。它支持持久会话、stdio 和 Streamable HTTP 传输、OAuth 2.1 认证（含 CIMD 和 DCR）、任务、JSON 输出（适合脚本化）、AI 沙箱代理以及实验性的 x402 支付。它旨在让 AI 代理通过单个 Bash() 工具调用即可使用完整的 MCP 协议，而无需集成多个 MCP 函数。