knowsuchagency/mcp2cli

MCP2CLI

어떤 MCP 서버, OpenAPI 사양, 또는 GraphQL 엔드포인트를 런타임에 코드생성 없이 CLI로 전환할 수 있습니다.
매 턴 도구 스키마에 낭비된 토큰의 96–99%를 절약하세요.
전체 글을 읽어보세요→

설치

AI 요원 스킬

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)에서 작동합니다.

OAuth 인증

OAuth가 필요한 API는 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.