← 返回目录
M

MCPorter

社区
将 MCP 工具带入脚本、CLI 和智能体
GitHub 源仓库 ↗
★ 5.0k Stars 分类 · 开发工具 非常热门 源版本 ae3d9000c320
63FMRS · C
可靠性
8/20
安全与权限
12/20
维护活跃度
17/20
文档质量
16/20
安装易用性
10/20

MCPorter 是一个多功能工具,适合在脚本和 CLI 中调用 MCP 工具,提供灵活的命令和 TypeScript API。它适用于开发者和编码智能体,但需要谨慎处理安全性和配置。

查看 FMRS 评分方法 →

MCPorter 是一个 TypeScript 运行时和命令行工具,用于发现和调用 Model Context Protocol(MCP)服务器。它面向需要在终端、脚本或生成的独立 CLI 中使用相同 MCP 工具的开发者和编码智能体。支持 stdio、Streamable HTTP 和旧版 SSE 服务器,可读取项目及用户配置,并能从 Cursor、Claude Code、Codex 等客户端导入服务器。提供 mcporter listcallresourceauthvaultgenerate-cliemit-tsrecordreplay 等命令。还提供 TypeScript 运行时 API,如 createRuntime()callOnce()createServerProxy(),便于在脚本中调用工具。

工具能力

list
列出 MCP 服务器及其工具
call
调用 MCP 工具并获取结果
resource
读取 MCP 资源
auth
完成或初始化 OAuth 认证
vault
管理认证密钥或令牌
generate-cli
为特定服务器生成独立的 CLI
emit-ts
生成 TypeScript 类型或客户端
record
录制一个可复现的 MCP 会话
replay
回放一个录制的 MCP 会话

安装接入

通过 npm 全局安装:npm install -g mcporter;或通过 Homebrew:brew install steipete/tap/mcporter。也可以使用 npx mcporter --version 尝试不安装的 CLI。Node 24 或更新版本要求。

选型与风险

适合谁

  • 需要从脚本或 CLI 调用 MCP 工具的开发者
  • 需要生成客户端或 CLI 的开发者
  • 使用 TypeScript 和 Node.js 的开发环境

不适合谁

  • 需要长期运行、常驻服务器端点的场景(这不是聚焦点)
  • 非 TypeScript 或 Node.js 环境
  • 需要高级认证和权限管理的用户(需要外部配置)

所需权限

  • 访问 MCP 服务器(网络或本地 stdio 命令)
  • 根据配置读取用户和项目配置文件
  • 生成的文件写入(如 CLI 生成或类型生成)

风险与副作用

  • 执行从 MCP 服务器获取的工具可能会产生副作用
  • 配置不当可能意外连接不受信任的服务器
  • 使用 OAuth 凭证时,如果配置不当可能造成安全风险

常见排障

  1. 检查 Node 版本(≥24)
  2. 验证服务器 URL 或命令是否正确
  3. 检查配置文件的 JSONC 格式和路径
  4. 尝试 `mcporter list` 以确认连通性

使用场景

从命令行快速检查公开 MCP 服务器并调用工具
将 MCP 工具集成到 TypeScript 脚本或运行时
为特定服务器生成独立的 CLI 工具
录制和回放 MCP 会话以进行可复现的测试
从其他客户端配置导入 MCP 服务器

支持客户端

暂未确认支持的客户端。