knowsuchagency/mcp2cli

MCP2CLI

Превратите любой MCP-сервер, спецификацию OpenAPI или конечную точку GraphQL в CLI — во время выполнения без кодагенерации.
Сохраняйте 96–99% жетонов, потраченных на схемы инструментов каждый ход.
Прочитайте полный текст →

Установка

Навык агента ИИ

MCp2cli поставляется с установленным навыком, который обучает AI-агентам кодирования (Claude Code, Cursor, Codex) его использовать. После установки ваш агент может обнаруживать и вызывать любой MCP-сервер или OpenAPI — а также генерировать новые навыки из API.

После установки попробуйте такие подсказки, как:

• mcp2cli --mcp https://mcp.example.com/sse — взаимодействие с MCP-сервером
• mcp2cli create a skill for https://api.example.com/openapi.json — генерировать навык из API

Использование

Режим MCP HTTP/SSE

--search подразумевает --list и работает во всех режимах (--mcp, --spec, --graphql, --mcp-stdio).

Аутентификация

API, требующие OAuth, поддерживаются сразу — в режимах MCP, OpenAPI и GraphQL. MCp2CLI автоматически занимается сбором токенов, кэшированием и обновлением.

Токены сохраняются в ~/.cache/mcp2cli/oauth/, поэтому последующие вызовы повторно используют существующие токены и обновляется автоматически, когда они истекают.

mcp2cli

Turn any MCP server, OpenAPI spec, or GraphQL endpoint into a CLI — at runtime, with zero codegen. Save 96–99% of the tokens wasted on tool schemas every turn. Read the full writeup →

Install

# Run directly without installing
uvx mcp2cli --help

# Or install globally
uv tool install mcp2cli

AI Agent Skill

mcp2cli ships with an installable skill that teaches AI coding agents (Claude Code, Cursor, Codex) how to use it. Once installed, your agent can discover and call any MCP server or OpenAPI endpoint — and even generate new skills from APIs.

npx skills add knowsuchagency/mcp2cli --skill mcp2cli

After installing, try prompts like:

• mcp2cli --mcp https://mcp.example.com/sse — interact with an MCP server
• mcp2cli create a skill for https://api.example.com/openapi.json — generate a skill from an API

Usage

MCP HTTP/SSE mode

# Connect to an MCP server over HTTP
mcp2cli --mcp https://mcp.example.com/sse --list

# Call a tool
mcp2cli --mcp https://mcp.example.com/sse search --query "test"

# With auth header
mcp2cli --mcp https://mcp.example.com/sse --auth-header "x-api-key:sk-..." \
  query --sql "SELECT 1"

# Force a specific transport (skip streamable HTTP fallback dance)
mcp2cli --mcp https://mcp.example.com/sse --transport sse --list

# Search tools by name or description (case-insensitive substring match)
mcp2cli --mcp https://mcp.example.com/sse --search "task"

--search implies --list and works across all modes (--mcp, --spec, --graphql, --mcp-stdio).

OAuth authentication

APIs that require OAuth are supported out of the box — across MCP, OpenAPI, and GraphQL modes. mcp2cli handles token acquisition, caching, and refresh automatically.

# Authorization code + PKCE flow (opens browser for login)
mcp2cli --mcp https://mcp.example.com/sse --oauth --list
mcp2cli --spec https://api.example.com/openapi.json --oauth --list
mcp2cli --graphql https://api.example.com/graphql --oauth --list

# Client credentials flow (machine-to-machine, no browser)
mcp2cli --spec https://api.example.com/openapi.json \
  --oauth-client-id "my-client-id" \
  --oauth-client-secret "my-secret" \
  list-pets

# With specific scopes
mcp2cli --graphql https://api.example.com/graphql --oauth --oauth-scope "read write" users

# Local spec file — use --base-url for OAuth discovery
mcp2cli --spec ./openapi.json --base-url https://api.example.com --oauth --list

Tokens are persisted in ~/.cache/mcp2cli/oauth/ so subsequent calls reuse existing tokens and refresh automatically when they expire.