跳到主要内容

Mcporter

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

技能元数据​

来源可选 — 通过 hermes skills install official/mcp/mcporter 安装
路径optional-skills/mcp/mcporter
版本1.0.0
作者社区
许可证MIT
平台linux, macos, windows
标签MCP, 工具, API, 集成, 互操作性

参考：完整的 SKILL.md​

信息

以下是当此技能被触发时，Hermes 加载的完整技能定义。这是技能激活时智能体所看到的指令。

mcporter

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

先决条件​

需要 Node.js：

# 无需安装（通过 npx 运行）
npx mcporter list

# 或全局安装
npm install -g mcporter

快速开始​

# 列出本机已配置的 MCP 服务器
mcporter list

# 列出特定服务器的工具及其 schema 详情
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 fix needed\")"

# 临时 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 <服务器.工具> --args '{"limit": 5}'

# 机器可读输出（推荐用于 Hermes）
mcporter call <服务器.工具> key=value --output json

认证与配置​

# 对服务器进行 OAuth 登录
mcporter auth <服务器 | url> [--reset]

# 管理配置
mcporter config list
mcporter config get <key>
mcporter config add <服务器>
mcporter config remove <服务器>
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 <名称>
mcporter generate-cli --command <url>

# 检查生成的 CLI
mcporter inspect-cli <路径> [--json]

# 生成 TypeScript 类型/客户端
mcporter emit-ts <服务器> --mode client
mcporter emit-ts <服务器> --mode types

注意事项​

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