前言¶
在 Agent 裏接 MCP，常見路徑是在 IDE 或客戶端裏逐個配服務器、等圖形界面刷新工具列表，再靠對話間接調用。排查某個工具是否可用、改認證或臨時起一個 stdio 服務時，往往缺少一條可腳本化、可復現的命令線入口。
下面介紹 SkillHub 上的 Mcporter（座標 @clawhub_steipete/mcporter）：它把 mcporter 這一套 CLI 能力寫進 Agent Skill，讓模型在對話中按文檔去列出、配置、認證和直接調用 MCP 服務器與工具，覆蓋 HTTP 與 stdio 兩種傳輸方式。
這是什麼¶
Mcporter 是面向開發編程場景（SkillHub 分類 dev-programming）的 Skill，版本 1.0.0，來源爲 clawhub，發佈者爲 steipete，上游頁面在 ClawHub。SkillHub 鏡像頁：Mcporter @ SkillHub。
一句話定位：通過 mcporter CLI 直接與 MCP 交互——列服務與工具、改配置、做 OAuth、調用工具，並支持臨時服務器、守護進程以及 CLI/TypeScript 代碼生成。標籤標明 requires_api_key=false，即 Skill 本身不強制額外 API Key（具體 MCP 服務仍可能有自己的認證要求）。
維護者在上游 ClawHub 標註爲 Peter Steinberger（@steipete）。
核心功能¶
以下能力均來自上游 Skill 說明，按用途歸納：
- 發現與查看：列出已配置的 MCP 服務器與工具，並可帶 schema 查看結構。
- 調用工具：支持多種選擇器寫法（
server.tool、函數式參數、完整 HTTP URL、stdio 子進程），以及 JSON 參數體。 - 認證與配置：OAuth 流程；對
mcporter.json做 list/get/add/remove/import，以及 login/logout。 - 守護進程：啓動、查看狀態、停止、重啓 mcporter daemon。
- 代碼生成：從指定 server 或 command 生成 CLI；檢查生成結果；按 client/types 模式輸出 TypeScript。
傳輸層明確支持 HTTP 與 stdio；說明中還提到可針對 臨時（ad-hoc）服務器 操作，適合本地調試未寫入長期配置的進程。
安裝與啓用¶
SkillHub
- 頁面：https://www.skillhub.cn/skills/clawhub_steipete/mcporter
- 座標：
@clawhub_steipete/mcporter - 官方聚合入口：https://api.skillhub.cn/zcwl/mcporter
在 SkillHub 或你所用的 Agent 產品中，按平臺提供的「從座標安裝 Skill」流程引用上述座標即可（具體菜單名稱因產品而異，以 SkillHub 當前頁面爲準）。
上游 ClawHub / OpenClaw
上游給出的安裝示例爲：
openclaw skills install @steipete/mcporter
安裝 Skill 之後，本機仍需能執行 mcporter 命令（CLI 由 mcporter 項目提供，Skill 負責教 Agent 如何正確使用這些命令）。默認配置文件路徑爲 ./config/mcporter.json，可用 --config 覆蓋。
Cursor、Codex CLI、Claude Code 等對 Skill 的安裝路徑與啓用開關各不相同；本文僅記錄 SkillHub 座標與上游 openclaw 示例，產品內步驟請以各產品文檔爲準。
典型用法¶
先做環境確認：在終端能運行 mcporter，且 Skill 已在 Agent 中啓用。之後可按下面順序操作（示例均來自上游文檔）。
快速瀏覽
mcporter list
mcporter list --schema
mcporter call <server.tool> key=value
調用工具的幾種寫法
mcporter call linear.list_issues team=ENG limit:5
mcporter call "linear.create_issue(title: \"Bug\")"
mcporter call https://api.example.com/mcp.fetch url:https://example.com
mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
mcporter call <server.tool> --args '{"limit":5}'
認證與配置
mcporter auth
mcporter auth --reset
mcporter config list
mcporter config get
mcporter config add
mcporter config remove
mcporter config import
mcporter config login
mcporter config logout
守護進程
mcporter daemon start
mcporter daemon status
mcporter daemon stop
mcporter daemon restart
代碼生成與檢查
mcporter generate-cli --server <name>
mcporter generate-cli --command <cmd>
mcporter inspect-cli
mcporter inspect-cli --json
mcporter emit-ts --mode client
mcporter emit-ts --mode types
需要給腳本或 Agent 解析時，上游建議優先加上 --output json，以便得到機器可讀結果。
經過上面的步驟，你可以在不改 IDE MCP 面板的情況下，用同一套命令驗證工具、批量改配置或對接 CI。
適用場景與注意¶
適合誰
- 需要在終端或自動化流水線裏直接調 MCP 工具，而不是隻通過聊天間接調用的人。
- 同時維護 HTTP 遠程 MCP 與 本地 stdio 服務（例如
bun run ./server.ts）的開發者。 - 希望從現有 MCP 服務生成 CLI 或 TypeScript 類型/客戶端，減少手寫膠水代碼的團隊。
限制與注意
- Skill 教的是 mcporter CLI 的用法；若本機未安裝 mcporter，僅安裝 Skill 無法執行命令。
- OAuth 與
config子命令會改動本地配置與登錄狀態，在共享機器或 CI 裏應使用獨立--config路徑，避免覆蓋個人環境。 - stdio 示例依賴你本地的運行時（如文檔中的
bun）；命令中的服務器路徑與工具名需與你實際 MCP 實現一致。 - SkillHub 統計（評分、下載、安裝次數）會隨時間變化；撰寫時頁面顯示爲高分與數萬級下載量級，以 SkillHub 技能頁 實時數據爲準。
結尾¶
Mcporter Skill 把 MCP 的「列、配、認證、調用」收斂到 mcporter 一條 CLI 上，並覆蓋配置編輯、守護進程與代碼生成，適合把 MCP 集成進日常開發與自動化。需要安裝或查看說明時，可從 SkillHub 座標 @clawhub_steipete/mcporter 或上游 https://clawhub.ai/steipete/mcporter 進入。
