Mcporter

Просмотр, аутентификация и вызов MCP-серверов и инструментов из терминала.

Метаданные навыка


Источник	Опциональный — установите командой `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

инфо

Ниже приведено полное определение навыка, которое Hermes Agent загружает при его активации. Именно этот текст агент получает в виде инструкций, когда навык включён.

mcporter

mcporter — инструмент для обнаружения, вызова и управления серверами и инструментами MCP (Model Context Protocol) прямо из терминала.

Требования

Нужен Node.js:

# Устанавливать не нужно (запуск через npx)
npx mcporter list

# Или глобальная установка
npm install -g mcporter

Quick Start

# Список MCP-серверов, уже настроенных на этой машине
mcporter list

# Список инструментов конкретного сервера со схемой
mcporter list <server> --schema

# Вызов инструмента
mcporter call <server.tool> key=value

Поиск MCP-серверов

mcporter автоматически обнаруживает серверы, настроенные другими MCP-клиентами (Claude Desktop, Cursor и т.п.) на этой машине. Чтобы найти новые серверы, можно просматривать реестры вроде mcpfinder.dev или mcp.so, а затем подключаться ad-hoc:

# Подключиться к любому MCP-серверу по URL (конфиг не нужен)
mcporter list --http-url https://some-mcp-server.com --name my_server

# Или запустить stdio-сервер на лету
mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs

Вызов инструментов

# Синтаксис key=value
mcporter call linear.list_issues team=ENG limit:5

# Функциональный синтаксис
mcporter call "linear.create_issue(title: \"Bug fix needed\")"

# Ad-hoc HTTP-сервер (конфиг не нужен)
mcporter call https://api.example.com/mcp.fetch url=https://example.com

# Ad-hoc stdio-сервер
mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com

# JSON-payload
mcporter call <server.tool> --args '{"limit": 5}'

# Машиночитаемый вывод (рекомендуется для Hermes)
mcporter call <server.tool> key=value --output json

Аутентификация и конфигурация

# OAuth-авторизация для сервера
mcporter auth <server | 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).

Daemon

Для постоянных подключений к серверам:

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

Генерация кода

# Сгенерировать CLI-обёртку для MCP-сервера
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 даёт структурированный вывод, который удобнее парсить.
Ad-hoc серверы (HTTP URL или команда --stdio) работают без какого-либо конфига — удобно для разовых вызовов.
OAuth-авторизация может потребовать интерактивного браузерного флоу — при необходимости используй terminal(command="mcporter auth <server>", pty=true).