// devtools · knowsuchagency/mcp2cli

mcp2cli

mcp2cli est un projet de développement open source, créé par knowsuchagency (knowsuchagency/mcp2cli sur GitHub). Il compte 2 416 étoiles sur GitHub et 179 forks, il est publié sous la licence MIT et a été mis à jour pour la dernière fois sur GitHub le 12 septembre 2026.

Turn any MCP server, OpenAPI spec or GraphQL endpoint into a CLI — at runtime, with zero codegen

★ 2,4 k étoiles⑂ 179 forksMITmis à jour sept. 2026
▦ visuel — le README de ce projet ne contient aucune capture intégrable,
voici donc un emplacement réservé. Le guide ci-dessous est complet malgré tout.
// détails du projet

Détails du projet

Étoiles GitHub
2 416
Forks
179
Licence
MIT
Dernière mise à jour sur GitHub
12 septembre 2026
Catégorie
Développement
Type de fiche
Guide d'installation complet
Site officiel
Official site
// fonctionnement

Comment ça marche

  1. Clarify your goal

    Pick your source: an MCP server (HTTP/SSE or stdio), an OpenAPI spec URL/file, or a GraphQL endpoint.

  2. Get mcp2cli

    Run it zero-install with uvx, or install it globally with uv tool.

  3. Connect and explore

    Run with --list (and --search) against your source, adding --oauth or --auth-header if the API needs authentication.

  4. Call and bake

    Call a tool/operation as a subcommand; if you'll reuse it, bake the connection into a named tool and call it with @name.

// fonctionnalités

Pourquoi on l'adore

Three source types

--mcp (HTTP/SSE), --mcp-stdio, --spec (OpenAPI JSON/YAML, local or remote) and --graphql modes all expose commands the same way.

Zero codegen

Commands are generated at runtime from the live schema — no client SDK to generate, build or keep in sync.

Built-in OAuth

Authorization-code + PKCE and client-credentials flows across all modes, with token caching/refresh and a manual-callback mode for headless hosts.

Secret hygiene

Auth values support env: and file: prefixes so secrets don't appear in process listings; baked configs mask known credential values.

Bake mode

Save a source, filters (--include/--exclude/--methods) and cache TTL as a named tool in ~/.config/mcp2cli/baked.json, even installable as a wrapper command.

Agent-friendly output

--json guarantees valid JSON on stdout, TOON output trims tokens on large arrays, usage-aware ranking keeps --list short, and specs are cached with a configurable TTL.

Advertisement
// lancez-le

Lancez-le vous-même

  1. Clone the repo

    Clone mcp2cli if you want the source; the normal path is uvx/uv in step 2.

    git clone https://github.com/knowsuchagency/mcp2cli.git
    cd mcp2cli
  2. Run or install

    Run directly without installing, or install it globally.

    uvx mcp2cli --help
    # or: uv tool install mcp2cli
  3. List and call tools

    List an MCP server's tools, then call one as a subcommand (OpenAPI and GraphQL sources work the same way with --spec / --graphql).

    mcp2cli --mcp https://mcp.example.com/sse --list
    mcp2cli --mcp https://mcp.example.com/sse search --query "test"
// cas d'usage

Ce que vous pouvez créer

  • Letting an agent use a big MCP server without loading all its schemas into context
  • Scripting an OpenAPI-based SaaS from the terminal without writing a client
  • Exploring a GraphQL API interactively with auto-generated queries
  • Turning a team's internal APIs into named, shareable CLI tools with bake mode
Advertisement
// faq

Questions fréquentes

Who maintains mcp2cli?

knowsuchagency maintains it; the package is on PyPI as mcp2cli.

Is it free?

Yes, MIT-licensed.

Does it need a paid API key?

Only whatever the target API itself requires — mcp2cli adds auth-header and OAuth support to supply it, including from env vars or files.

How does it compare to an MCP gateway like MetaMCP?

A gateway hosts aggregated servers for clients to connect to. mcp2cli is the opposite direction: it consumes MCP/OpenAPI/GraphQL sources and presents them as a local CLI for humans, scripts and agents.

How do I get started?

uvx mcp2cli --help, then mcp2cli --spec <openapi.json URL> --list and call an operation.

// continuez l'exploration

Outils similaires

Développement

OpenCLI

Turn any website into a CLI — and let AI agents drive your already-logged-in browser

★ 29,9 k étoilesApache-2.0
Voir le guide →
Développement

ripwire

The ripgrep of AI context — a zero-dependency C++23 CLI + MCP server that maps your repo for coding agents

★ 2,4 k étoilesApache-2.0
Voir le guide →
Développement

agents-cli

The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.

★ 6,0 k étoilesApache-2.0
Voir le guide →
Développement

CodeGraphContext

An MCP server plus a CLI tool that indexes local code into a graph database to provide context to AI assistants.

★ 4,2 k étoilesMIT
Voir le guide →
Développement

mcp-proxy

A bridge between Streamable HTTP / SSE and stdio MCP transports — connect any client to any server

★ 2,8 k étoilesMIT
Voir le guide →
Développement

gitdiagram

Turn any GitHub repo into an interactive architecture diagram - just swap 'hub' for 'diagram'

★ 18,0 k étoilesMIT
Voir le guide →
// alternatives

Alternatives en Développement

Les autres projets de la catégorie Développement avec le plus d'étoiles du catalogue LibreAI — la sélection réaliste d'alternatives si mcp2cli ne vous convient pas.

  • OpenCode★ 211,6 k

    The open source coding agent

  • Transformers★ 166,9 k

    The model-definition framework behind modern AI — thousands of pretrained transformers for text, vision, and audio.

  • claude-code★ 149,7 k

    Anthropic's agentic coding tool that lives in your terminal and works across your whole codebase

  • cc-switch★ 141,3 k

    Cross-platform desktop all-in-one manager for Claude Code, Codex, OpenCode and other coding agents

  • codex★ 128,2 k

    OpenAI's lightweight coding agent that runs locally in your terminal

// plus en devtools

Plus en Développement

Projets de la catégorie Développement proches dans le catalogue, les plus proches en étoiles de mcp2cli — continuez à explorer de part et d'autre.

  • ripwire★ 2,4 k

    The ripgrep of AI context — a zero-dependency C++23 CLI + MCP server that maps your repo for coding agents

  • claude-skills-llm-council★ 2,3 k

    LLM Council — a Claude Code skill that runs your decisions through 5 AI advisors with peer review

  • drama-skills★ 2,5 k

    开源 AI 短剧/漫剧创作 skill 合集:剧本、角色资产、分镜 storyboard、图片/视频提示词、审查,适配 Claude Code 与 Codex | Open-source AI short drama / micro-drama skills for Claude Code & Codex: sc…

  • DataDesigner★ 2,3 k

    NVIDIA NeMo Data Designer: build validated, multimodal synthetic datasets from scratch or from seed data.

  • agentic-ai-prompt-research★ 2,6 k

    Research into how agentic AI coding assistants work. Reconstructed prompt patterns, agent coordination, and security classification

  • pentest-ai-agents★ 2,3 k

    AI subagents that turn Claude Code into an authorized penetration-testing assistant.

Obtenir mcp2cli

Gratuit et ouvert : récupérez le code source, mettez une étoile au dépôt et commencez à créer.