Mcporter

Используйте CLI mcporter для просмотра, настройки, аутентификации и вызова MCP-серверов/инструментов напрямую (HTTP или stdio), включая ad-hoc серверы, редактирование конфигурации и генерацию CLI/типов.

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

Источник	Опционально — установите с помощью vibeos skills install official/mcp/mcporter
Путь	optional-skills/mcp/mcporter
Версия	1.0.0
Автор	community
Лицензия	MIT
Платформы	linux, macos, windows
Теги	MCP, Tools, API, Integrations, Interop

Справочник: полный SKILL.md

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

mcporter

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

Предварительные требования

Требуется Node.js:

# Установка не требуется (запускается через npx)
npx mcporter list

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

Быстрый старт

# Просмотр 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

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

# Синтаксис ключ=значение
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}'

# Машиночитаемый вывод (рекомендуется для VibeOS)
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).

Демон

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

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)