Agent Skills
› NousResearch/hermes-agent
› mcporter
mcporter
GitHub用于在终端发现、认证和调用MCP服务器及工具的命令行助手。支持自动发现已配置服务，通过HTTP或stdio连接临时服务器，执行工具调用并生成结构化输出，同时提供OAuth认证、持久化守护进程管理及代码生成功能。
Trigger Scenarios
需要列出可用的MCP服务器
需要通过终端调用MCP工具
需要为MCP服务器进行身份验证
需要从URL或脚本临时连接MCP服务
Install
npx skills add NousResearch/hermes-agent --skill mcporter -g -y
SKILL.md
Frontmatter
{
"name": "mcporter",
"author": "community",
"license": "MIT",
"version": "1.0.0",
"metadata": {
"hermes": {
"tags": [
"MCP",
"Tools",
"API",
"Integrations",
"Interop"
],
"homepage": "https:\/\/mcporter.dev"
}
},
"platforms": [
"linux",
"macos",
"windows"
],
"description": "List, auth, and call MCP servers\/tools from the terminal.",
"prerequisites": {
"commands": [
"npx"
]
}
}
mcporter
Use mcporter to discover, call, and manage MCP (Model Context Protocol) servers and tools directly from the terminal.
Prerequisites
Requires Node.js:
# No install needed (runs via npx)
npx mcporter list
# Or install globally
npm install -g mcporter
Quick Start
# List MCP servers already configured on this machine
mcporter list
# List tools for a specific server with schema details
mcporter list <server> --schema
# Call a tool
mcporter call <server.tool> key=value
Discovering MCP Servers
mcporter auto-discovers servers configured by other MCP clients (Claude Desktop, Cursor, etc.) on the machine. To find new servers to use, browse registries like mcpfinder.dev or mcp.so, then connect ad-hoc:
# Connect to any MCP server by URL (no config needed)
mcporter list --http-url https://some-mcp-server.com --name my_server
# Or run a stdio server on the fly
mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs
Calling Tools
# Key=value syntax
mcporter call linear.list_issues team=ENG limit:5
# Function syntax
mcporter call "linear.create_issue(title: \"Bug fix needed\")"
# Ad-hoc HTTP server (no config needed)
mcporter call https://api.example.com/mcp.fetch url=https://example.com
# Ad-hoc stdio server
mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
# JSON payload
mcporter call <server.tool> --args '{"limit": 5}'
# Machine-readable output (recommended for Hermes)
mcporter call <server.tool> key=value --output json
Auth and Config
# OAuth login for a server
mcporter auth <server | url> [--reset]
# Manage config
mcporter config list
mcporter config get <key>
mcporter config add <server>
mcporter config remove <server>
mcporter config import <path>
Config file location: ./config/mcporter.json (override with --config).
Daemon
For persistent server connections:
mcporter daemon start
mcporter daemon status
mcporter daemon stop
mcporter daemon restart
Code Generation
# Generate a CLI wrapper for an MCP server
mcporter generate-cli --server <name>
mcporter generate-cli --command <url>
# Inspect a generated CLI
mcporter inspect-cli <path> [--json]
# Generate TypeScript types/client
mcporter emit-ts <server> --mode client
mcporter emit-ts <server> --mode types
Notes
- Use
--output jsonfor structured output that's easier to parse - Ad-hoc servers (HTTP URL or
--stdiocommand) work without any config — useful for one-off calls - OAuth auth may require interactive browser flow — use
terminal(command="mcporter auth <server>", pty=true)if needed
Version History
- e0dfcf2 Current 2026-07-25 11:36
