mcporter — 安装部署及使用完全指南(一)
MCP, made portable.让 AI 代理和开发者无需编写样板代码即可调用任何 MCP 服务器。一、概述1.1 mcportermcporter是一个 TypeScript 运行时、CLI 和代码生成工具包专为Model Context Protocol (MCP)设计。它让 AI 代理和开发人员无需编写样板代码即可调用任何 MCP 服务器。属性说明官网https://mcporter.sh/GitHubhttps://github.com/openclaw/mcporter包管理器npm / pnpm / Bun / HomebrewNode.js 要求Node.js 24️平台macOS (arm64 / x86_64), Linux, Windows (WSL)1.2 “Porter”Porter行李员在火车站之间搬运行李。mcporter 对 MCP 服务器做同样的事情它在你的代理或终端和另一端的 MCP 服务器之间搬运工具调用、Schema、OAuth 令牌和 stdio 句柄。你无需提前了解服务器的具体形状运行时保持连接温热重复调用成本极低。1.3 mcporter 能做的分类功能发现与连接 自动发现 Cursor / Claude / Codex / Windsurf / OpenCode / VS Code 中的 MCP 服务器 支持 stdio / HTTP / SSE 三种传输协议 内置 OAuth 认证与令牌刷新调用与交互️ 调用 MCP 工具多种参数语法 读取 MCP 资源 多种输出格式text / markdown / json / raw代码生成️ 生成独立 CLI可打包为单文件 生成 TypeScript 类型定义和客户端运行时与桥接⚡ Keep-Alive 守护进程保持状态连接 MCP 桥接将多个服务器暴露为单个 MCP 服务器1.4 适配 Agentmcporter 遵循 Anthropic 推荐的“code-execution-with-MCP”模式跳过庞大的工具 Schema 提示词生成一个小的类型化表面让代理或人类像调用普通函数一样调用 MCP 服务器。推荐工作流配置 MCP 服务器mcporter list 查看工具签名mcporter emit-ts 生成类型编写小型 per-server Agent 技能mcporter call 调用工具需要分享mcporter generate-cli二、安装2.1 无需安装即可试用推荐首次使用# 查看版本npx mcporter--version# 列出所有已发现的 MCP 服务器npx mcporter listnpx会将包保留在 npm 缓存中后续运行即时执行。这是推荐的第一步。2.2 npm / pnpm / Bun 安装全局安装推荐日常 CLI 使用npminstall-gmcporter项目内安装推荐在 TypeScript 项目中使用运行时 APIpnpmaddmcporter# 或: npm install mcporter / bun add mcporter要求: Node.js 24。Bun 下也可运行。包同时暴露可导入的运行时createRuntime、callOnce、createServerProxy和mcporterCLI 二进制文件。2.3 HomebrewmacOSbrewinstallsteipete/tap/mcporter如果之前从旧 tap 安装过先运行brew update再重新安装确保 Homebrew 能识别新的 formula 路径。2.4 独立二进制文件macOS每个发布版本提供针对 macOS arm64 和 x86_64 的 Bun 编译独立二进制文件架构文件名Apple Silicon (M1/M2/M3/M4)mcporter_version_darwin_arm64.tar.gzIntel Macmcporter_version_darwin_x86_64.tar.gz安装步骤从 GitHub Releases 下载对应架构的 tar.gz用checksums.txt验证文件完整性解压到$PATH中的目录如~/.local/bin/ 官方 macOS 二进制使用 OpenClaw Foundation Developer ID 团队FWJYW4S8P8进行代码签名和 Apple 公证包含硬化运行时和时间戳。provenance.json记录了签名标签、提交哈希、构建器版本等元数据。2.5 ✅ 验证安装mcporter--versionmcporter list第一次运行会打印 mcporter 从各个配置中发现的 MCP 服务器。如果没有任何输出说明还没有配置服务器继续往下看 。2.6 更新安装方式更新命令npmnpm install -g mcporterlatestpnpmpnpm up -g mcporterlatestHomebrewbrew upgrade steipete/tap/mcporter独立二进制下载新版本替换旧文件2.7 ️ 卸载# npmnpmuninstall-gmcporter# Homebrewbrew uninstall steipete/tap/mcporter# 独立二进制删除 $PATH 中的文件 mcporter 将 OAuth 令牌和缓存 Schema 存储在~/.mcporter/或$XDG_CACHE_HOME/mcporter/。如需完全清除手动删除该目录。三、快速入门5 分钟上手本教程使用公开的Context7MCP 服务器无需现有 MCP 配置即可跟随操作。3.1 添加 Context7 服务器npx mcporter configaddcontext7 https://mcp.context7.com/mcp--scopehome--scope home将配置保存到用户目录~/.mcporter/mcporter.json不影响项目配置。3.2 列出所有已发现的 MCP 服务器npx mcporter list输出每行一个服务器包含认证状态 、传输类型 和工具数量 。常用标志标志说明--json机器可读 JSON 输出--quiet静默健康检查--verbose查看每个服务器的注册来源3.3 查看单个服务器的工具签名npx mcporter list context7输出类似 TypeScript 头文件带/** … */文档注释的function name(...)签名。可选参数被精简以保持屏幕可读性。进阶标志标志说明--brief/--signatures仅显示紧凑签名--all-parameters显示所有可选参数--schema格式化打印 JSON Schema--json机器可读 Schema--status仅状态摘要3.4 调用工具# 冒号分隔标志shell 友好npx mcporter call context7.resolve-library-id query:React hooks docslibraryName:react# 函数调用风格可直接从 mcporter list 输出复制npx mcporter callcontext7.resolve-library-id(query: React hooks docs, libraryName: react)3.5 选择输出格式# 纯文本默认npx mcporter call context7.resolve-library-id query:react--outputtext# Markdownnpx mcporter call context7.resolve-library-id query:react--outputmarkdown# JSON适合管道处理npx mcporter call context7.resolve-library-id query:react--outputjson# 原始输出npx mcporter call context7.resolve-library-id query:react--outputraw--json在 stdout 生成稳定 JSON 信封人类可读的进度、提示和警告始终输出到 stderr确保管道解析不受影响。3.6 读取 MCP 资源# 列出资源npx mcporter resource my-resource-server# 读取特定资源npx mcporter resource my-resource-server file:///path/to/spec.md3.7 生成独立 CLI当你想分享一个工具给不需要学习mcporter call的人npx mcporter generate-cli context7--runtimenode--bundlerrolldown--bundledist/context7.js# 使用生成的 CLInodedist/context7.js resolve-library-id--queryReact hooks docs--library-name react3.8 生成类型化客户端# 仅类型定义npx mcporter emit-ts context7--modetypes--outtypes/context7-tools.d.ts# 完整客户端含工厂函数npx mcporter emit-ts context7--modeclient--outsrc/context7-client.ts

相关新闻

JavaScript Proxy与Reflect:对象拦截与代理实战指南

JavaScript Proxy与Reflect:对象拦截与代理实战指南

1. JavaScript拦截与代理机制解析 Proxy和Reflect是ES6引入的两个强大特性,它们共同构成了JavaScript中对象拦截与代理的核心机制。在实际开发中,我经常使用这对组合来实现各种高级功能,从简单的属性拦截到复杂的元编程应用。 1.1 Proxy基础…

2026/11/16 13:13:02 阅读更多 →
Adobe软件订阅验证失败:从网络到本地的系统性排查与修复指南

Adobe软件订阅验证失败:从网络到本地的系统性排查与修复指南

1. 问题现象与核心矛盾:当“正版”软件拒绝你时 如果你正在使用 Adobe Dreamweaver 2020,某天启动时,突然弹出一个让你心头一紧的对话框:“我们无法验证您的订阅状态。我们无法访问Adobe服务器。这可能是因为您未连接到Internet。…

2026/11/13 16:06:36 阅读更多 →
SS6810H 步进电机驱动芯片:轻量化运动控制的高效优选方案

SS6810H 步进电机驱动芯片:轻量化运动控制的高效优选方案

一、产品基础硬件规格,适配多场景供电需求 SS6810H 采用单电源简化供电架构,标准工作电压区间为 10V 至 32V,能够兼容绝大多数小型机电设备的直流供电方案。芯片内部集成两路独立 H 桥驱动单元,每相可持续输出 1.0A 额定电流&…

2026/11/14 12:28:39 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻