On this page Используйте CLI-инструмент mcporter для просмотра, настройки, аутентификации и вызова MCP-серверов/инструментов напрямую (через HTTP или stdio), включая ad-hoc серверы, редактирование конфигурации и генерацию CLI/типов.
Skill metadata¶
| Source |
| Path |
| Version |
| Author |
| License |
| Tags |
Reference: full SKILL.md¶
info Ниже приведено полное описание скилла, которое Hermes загружает при активации этого скилла. Это те инструкции, которые видит агент, когда скилл активен.
mcporter¶
Используйте mcporter для обнаружения, вызова и управления серверами и инструментами MCP (Model Context Protocol) прямо из терминала.
Prerequisites¶
Требуется Node.js:
[code]
# Установка не требуется (запуск через npx)
npx mcporter list
# Или глобальная установка
npm install -g mcporter
[/code]
Quick Start¶
[code]
# Список MCP-серверов, уже настроенных на этой машине
mcporter list
# Список инструментов конкретного сервера с описанием схемы
mcporter list <server> --schema
# Вызов инструмента
mcporter call <server.tool> key=value
[/code]
Discovering MCP Servers¶
mcporter автоматически обнаруживает серверы, настроенные другими MCP-клиентами (Claude Desktop, Cursor и т.д.) на этой машине. Чтобы найти новые серверы, просмотрите реестры вроде mcpfinder.dev или mcp.so, затем подключитесь ad-hoc:
[code]
# Подключение к любому 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
[/code]
Calling Tools¶
[code]
# Синтаксис 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-полезная нагрузка
mcporter call <server.tool> --args '{"limit": 5}'
# Машиночитаемый вывод (рекомендуется для Hermes)
mcporter call <server.tool> key=value --output json
[/code]
Auth and Config¶
[code]
# OAuth-логин для сервера
mcporter auth
# Управление конфигурацией
mcporter config list
mcporter config get <key>
mcporter config add <server>
mcporter config remove <server>
mcporter config import <path>
[/code]
Расположение файла конфигурации: ./config/mcporter.json (переопределяется через --config).
Daemon¶
Для постоянных подключений к серверам:
[code]
mcporter daemon start
mcporter daemon status
mcporter daemon stop
mcporter daemon restart
[/code]
Code Generation¶
[code]
# Генерация CLI-обёртки для MCP-сервера
mcporter generate-cli --server
mcporter generate-cli --command
# Просмотр сгенерированного CLI
mcporter inspect-cli <path> [--json]
# Генерация TypeScript-типов/клиента
mcporter emit-ts <server> --mode client
mcporter emit-ts <server> --mode types
[/code]
Notes¶
- Используйте
--output jsonдля структурированного вывода, который проще парсить - Ad-hoc серверы (HTTP URL или команда
--stdio) работают без какой-либо конфигурации — удобно для разовых вызовов -
OAuth-аутентификация может потребовать интерактивного взаимодействия с браузером — при необходимости используйте
terminal(command="mcporter auth <server>", pty=true) - Reference: full SKILL.md
- Prerequisites
- Quick Start
- Discovering MCP Servers
- Calling Tools
- Auth and Config
- Daemon
- Code Generation
- Notes