网硕互联帮助中心【免费下载链接】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 across servers, proxy for AI sandboxes, x402 & more.
项目地址：
https://gitcode.com/gh_mirrors/mcp/mcpc
点击查看 免费下载
mcpc 是目前兼容性最强的 MCP（Model Context Protocol）CLI 客户端：它把 MCP 的每一项操作都映射成一条好懂的 shell 命令，完整支持 tools、resources、prompts、异步任务、skills 等能力，同时支持 stdio 与 Streamable HTTP 两种服务器传输方式。本教程面向零基础新手，带你在 5 分钟内完成 mcpc 安装、登录远程 MCP 服务器，并连接你的第一个 MCP 服务器会话，全程只有 4 条核心命令。
一、mcpc 是什么？能帮你做什么？
简单说，mcpc 就是"给 MCP 服务器配了一个瑞士军刀"：
| 🔧 完整 MCP 支持 | tools、prompts、resources、异步任务、skills、通知与日志 |
| 🔄 持久会话 | 一次 connect，多个会话并行保活，随时继续 |
| 📋 渐进式发现 | 用 grep 跨所有服务器搜索工具，不用把全部工具塞进上下文 |
| 🔒 安全 | 完整 OAuth 2.1（PKCE / DCR / CIMD），凭据存系统 keychain |
| 📦 轻量 | 依赖极少，Mac / Windows / Linux 通用，自带命令行不依赖大模型 |
下图是 mcpc 实际运行效果：上半部分列出当前所有 MCP 会话与 OAuth 认证 profile，下半部分展示一个文件系统服务器会话中列出的 14 个工具。
二、mcpc 安装步骤：3 种方式选一个
前置条件：系统装有 Node.js ≥ 22.12 或 Bun（Homebrew 方式会自带 Node.js）。
方式一：Homebrew（macOS / Linux，推荐）
brew install apify/tap/mcpc
方式二：npm 全局安装
npm install -g @apify/mcpc
方式三：Bun 全局安装
bun install -g @apify/mcpc
验证安装是否成功：
mcpc –version
能看到版本号，说明安装完成 ✅
💡 Linux 无桌面环境下，mcpc 会自动回退到文件存储（~/.mcpc/credentials.json，权限 0600），不影响使用。
三、mcpc login：登录远程 MCP 服务器（OAuth 2.1）
需要 OAuth 认证的远程 MCP 服务器，用一条 login 命令就能完成登录，凭据会自动保存到系统 keychain，以后免登：
mcpc login mcp.apify.com
执行后终端会自动打开浏览器登录页，登录成功后返回终端，mcpc 就把这套凭据存成了一个名为 default 的 OAuth profile（认证档案）。
新手只需记住两个要点：
- 一个服务器可以有多个 profile：用 –profile work 给不同账号起名字，例如：
mcpc login mcp.apify.com –profile work # 保存"工作账号"
mcpc login mcp.apify.com # 保存"默认账号"
- 不想要了可以删：mcpc logout mcp.apify.com –profile work。
不需要登录的公开服务器或本地 stdio 服务器可以跳过这一步，直接匿名 connect。
四、mcpc connect：连接你的第一个 MCP 服务器
这是全文最关键的一条命令——创建一个命名的持久会话，之后所有交互都通过这个 @会话名 进行：
mcpc connect mcp.apify.com @test
- mcp.apify.com：服务器地址（省略 https:// 也行）
- @test：给这个会话起的名字，@ 前缀是约定写法
连接成功后，直接运行 mcpc 不带任何参数，就能看到当前所有活跃会话和已保存的 OAuth profile：
mcpc
下面的动画完整演示了"连接 → 列工具 → 调用工具 → 关闭会话"的第一次使用流程，正好就是本节到下一节要做的事：
五、和服务器对话：tools-list 与 tools-call
会话建好之后，最常用的就是两条命令：
# 1. 看看这个服务器提供了哪些工具
mcpc @test tools-list
# 2. 调用其中一个工具（参数用 key:=value 写法）
mcpc @test tools-call search-actors keywords:="website crawler" limit:=3
调用参数的小技巧：
- 数字和布尔值会自动识别：limit:=3、enabled:=true
- 复杂参数可以整段传 JSON：mcpc @test tools-call <tool> '{"keywords":"crawler","limit":2}'
- 用完的会话用 mcpc @test close 关闭；想重连就 mcpc @test restart
六、三个让效率翻倍的小技巧
1️⃣ grep 跨会话搜工具 —— 连了很多服务器不知道哪个有某功能？一条命令全搜出来（相当于"工具版 grep"）：
mcpc grep "search" # 搜索所有活跃会话中的工具
mcpc grep "config" –resources –prompts
2️⃣ –json 脚本模式 —— 所有命令加 –json 就输出标准 JSON，可无缝配合 jq、xargs 写成自动化脚本，完整示例见 docs/examples/company-lookup.sh。
3️⃣ 连接本地 stdio 服务器 —— 支持直接引用 IDE 的 MCP 配置文件条目（例如 VS Code 的 mcp.json）：
mcpc connect ./.vscode/mcp.json:filesystem @fs
mcpc @fs tools-list
配置文件长什么样，可以参考仓库里的示例 docs/examples/mcp-config.json，支持远程 URL、headers、本地 stdio 命令等多种写法。
七、新手常见问题
Q：如何查看会话状态？ 直接运行 mcpc，live 表示正常，异常状态（crashed、unauthorized 等）都会给出修复提示。
Q：提示 unauthorized 怎么办？ 重新 mcpc login <server> 刷新凭据，再 mcpc @test restart 即可。
Q：如何清理旧会话和日志？ mcpc clean 清理过期会话与旧日志，mcpc clean all 全部清除。
Q：连接失败时想排查？ 加 –verbose 开启调试日志；自签证书加 –insecure。
八、下一步：继续深入
- 📖 想看每个命令的完整参数说明：docs/REFERENCE.md
- 🧭 项目功能总览与安全设计：README.md
- 📝 脚本实战案例：docs/examples/company-lookup.sh
- 🛡️ 给 AI Agent 配沙箱代理（–proxy）的高级玩法，详见 README 中的 "MCP proxy" 章节
至此你已经完成了 mcpc 的安装、登录并连接了第一个 MCP 服务器 🎉 剩下的，就是用它多调几个工具，感受"命令行玩转 MCP"的爽快了。
赞
【免费下载链接】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 across servers, proxy for AI sandboxes, x402 & more.
项目地址：
https://gitcode.com/gh_mirrors/mcp/mcpc
点击查看 免费下载
相关推荐
深度解析Windows权限提升工具：从原理到实战应用
vn.py量化交易框架：新手快速上手的终极指南
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
评论前必须登录！
注册