{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md，而非此页面。 */}

Mcporter

使用 mcporter CLI 直接列出、配置、认证和调用 MCP 服务器/工具（HTTP 或 stdio），包括临时服务器、配置编辑和 CLI/类型生成。

技能元数据

来源	可选 —— 使用 hermes skills install official/mcp/mcporter 安装
路径	optional-skills/mcp/mcporter
版本	1.0.0
作者	community
许可证	MIT
平台	linux, macos, windows
标签	MCP, Tools, API, Integrations, Interop

参考：完整 SKILL.md

:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::

mcporter

使用 mcporter 从终端发现、调用和管理 MCP（模型上下文协议） 服务器和工具。

前提条件

需要 Node.js：

# 无需安装（通过 npx 运行）
npx mcporter list
 
# 或全局安装
npm install -g mcporter

快速开始

# 列出本机已配置的 MCP 服务器
mcporter list
 
# 列出特定服务器的工具及模式详情
mcporter list <服务器> --schema
 
# 调用工具
mcporter call <服务器.工具> key=value

发现 MCP 服务器

mcporter 自动发现由本机其他 MCP 客户端（Claude Desktop, Cursor 等）配置的服务器。要查找可用的新服务器，浏览 mcpfinder.dev 或 mcp.so 等注册表，然后临时连接：

# 按 URL 连接到任何 MCP 服务器（无需配置）
mcporter list --http-url https://some-mcp-server.com --name my_server
 
# 或即时运行 stdio 服务器
mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs

调用工具

# 键=值语法
mcporter call linear.list_issues team=ENG limit:5
 
# 函数语法
mcporter call "linear.create_issue(title: \"需要修复 Bug\")"
 
# 临时 HTTP 服务器（无需配置）
mcporter call https://api.example.com/mcp.fetch url=https://example.com
 
# 临时 stdio 服务器
mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
 
# JSON 负载
mcporter call <server.tool> --args '{"limit": 5}'
 
# 机器可读输出（推荐用于 Hermes）
mcporter call <server.tool> key=value --output json

认证和配置

# OAuth 登录到服务器
mcporter auth <服务器 | url> [--reset]
 
# 管理配置
mcporter config list
mcporter config get <key>
mcporter config add <server>
mcporter config remove <server>
mcporter config import <path>

配置文件位置：./config/mcporter.json（使用 --config 覆盖）。

守护进程

用于持久服务器连接：

mcporter daemon start
mcporter daemon status
mcporter daemon stop
mcporter daemon restart

代码生成

# 为 MCP 服务器生成 CLI 包装器
mcporter generate-cli --server <name>
mcporter generate-cli --command <url>
 
# 检查生成的 CLI
mcporter inspect-cli <path> [--json]
 
# 生成 TypeScript 类型/客户端
mcporter emit-ts <server> --mode client
mcporter emit-ts <server> --mode types

注意事项

• 使用 --output json 获取易于解析的结构化输出
• 临时服务器（HTTP URL 或 --stdio 命令）无需任何配置 —— 适合一次性调用
• OAuth 认证可能需要交互式浏览器流程 —— 如有需要，使用 terminal(command="mcporter auth <server>", pty=true)