← 返回目录

MCPorter

社区

框架 / SDK

将 MCP 工具带入脚本、CLI 和智能体

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

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

分类: 开发工具第 74 / 438
Stars: ★ 5.1k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 24+
凭据: 无需凭据
许可证: MIT
最近提交: 今天
工具数: 9

63FMRS · C

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

最强项 · 维护活跃度 17/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

17/20

文档质量

16/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 仓库声称支持多种传输和协议，并提供了CI和测试的显著证据。然而，由于静态审查无法执行代码，且依赖未验证的构建和测试细节，因此依据校准规则，分数被限制在12以下。根据README的评价，代码组织良好，但未验证错误处理和边缘情况。
安全与权限 12/20: 该工具处理OAuth和凭据，仓库似乎有安全实践，但静态审查无法确认凭据存储和验证流程。未发现明确的危险操作确认（如有意删除或远程命令执行），因此不存在明显红线。然而，最不权和数据流披露的细节未完全验证，因此给12分。
维护活跃度 17/20: 仓库活跃，有近期提交、清晰的许可证（MIT）和CI工作流。维护良好，但无法验证版本历史和问题响应。高星数和低开放问题数是积极的信号，但仅作为发现信号，不能直接加分。
文档质量 16/20: 有丰富的文档，包括安装指南、CLI参考、配置、协议和故障排除的链接。文档似乎全面且分层，但静态审查无法验证准确性。README提供了示例，但未发现明确的限制说明。
安装易用性 10/20: 安装说明清晰，支持多种方法（npx、brew、npm）。需要Node 24或更高版本，这可能是一个限制。配置示例很简单，但未提供主流客户端的配置示例。由于静态审查无法执行验证，因此上限为15分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Node.js 24+

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

验证是否装好

运行 npx mcporter --version 确认安装成功，然后运行 npx mcporter list https://mcp.context7.com/mcp --brief，能打印出该服务器的工具签名即证明连接正常。

常见排障

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

试试这样问

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

列出 https://mcp.context7.com/mcp 这个服务器上的所有工具
用 mcporter 调用 resolve-library-id 工具，查询 React hooks 文档对应的库 ID
把 context7 服务器的工具生成为一个独立的命令行 CLI
生成 context7 服务器的 TypeScript 类型化客户端

工具能力 9

list 只读

列出 MCP 服务器及其工具

call 只读

调用 MCP 工具并获取结果

resource 只读

读取 MCP 资源

auth 写入

完成或初始化 OAuth 认证

vault 只读

管理认证密钥或令牌

generate-cli 写入

为特定服务器生成独立的 CLI

emit-ts 写入

生成 TypeScript 类型或客户端

record 写入

录制一个可复现的 MCP 会话

展开其余 1 个工具

replay 只读

回放一个录制的 MCP 会话

使用场景

从命令行快速检查公开 MCP 服务器并调用工具

将 MCP 工具集成到 TypeScript 脚本或运行时

为特定服务器生成独立的 CLI 工具

录制和回放 MCP 会话以进行可复现的测试

从其他客户端配置导入 MCP 服务器

详细介绍

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