mcpc – univerzální CLI klient pro MCP

Vytvořeno: 5.5.2026 | Aktualizováno: 05.05.2026 09:47

mcpc je open-source CLI klient pro Model Context Protocol (MCP), který vytvořil Apify. Umožňuje komunikovat s MCP servery přímo z příkazové řádky – jak interaktivně pro testování a ladění, tak programaticky pro použití v AI agentech a shellových skriptech.

Kolem MCP a CLI nástrojů existuje staré pnutí: AI agenti někdy preferují CLI, protože ho znají „nazpaměť„, spouštějí nástroje jako kód přes Bash() a nepotřebují nahrávat veškerou dokumentaci do kontextu najednou. MCP oproti tomu nabízí standardní protokol pro autentizaci, transport a přístup ke zdrojům – to CLI tradičně postrádá.

Autoři projektu toto dilema pojmenovali přesně: problém není v MCP samotném, ale v tom, jak ho klienti implementují. Většina MCP klientů načítá všechny nástroje i jejich výsledky do kontextu najednou, což zbytečně zvyšuje cenu a způsobuje context rot. mcpc navrhuje jiný přístup: kombinovat silné stránky obou světů – MCP pro standardizovaný vzdálený přístup, CLI pro lokální rozhraní agenta.

Projekt byl představen na Vibecoding Talks v dubnu 2026 Janem Curnem z Apify. Apify zároveň deklarovalo záměr darovat mcpc do Agentic AI Foundation (AAIF) jako kandidáta na oficiální MCP CLI klient pro shellové prostředí.

• Plná podpora MCP – všechny funkce protokolu, HTTP i stdio transport
• Lehký a minimálně závislý – žádné LLM, funguje na Mac / Windows / Linux
• Přátelský pro agenty i lidi – jeden nástroj, dvě perspektivy použití
• Code mode s –json – výstup lze skládat v shellu přes jq a pipelines

npm install -g @apify/mcpc
# nebo přes Bun
bun install -g @apify/mcpc

Na Linuxu bez grafického prostředí je pro bezpečné ukládání přihlašovacích údajů potřeba nainstalovat libsecret a gnome-keyring.

mcpc pracuje s pojmenovanými sessions prefixovanými @. Session je persistentní připojení k MCP serveru, které přežívá mezi příkazy.

# Přihlášení a připojení k serveru
mcpc login mcp.apify.com
mcpc connect mcp.apify.com @apify
 
# Výpis dostupných nástrojů
mcpc @apify tools-list
 
# Volání nástroje
mcpc @apify tools-call search-actors keywords:="website crawler"
 
# Interaktivní shell
mcpc @apify shell

Stav session může být: 🟢 live, 🟡 connecting / reconnecting / disconnected / crashed, 🔴 unauthorized / expired.

mcpc @apify restart
mcpc @apify close

# Hledání napříč všemi sessions
mcpc grep "search"
 
# Hledání jen v konkrétní session
mcpc @apify grep "actor"

Pro použití v AI agentech nebo shellových skriptech mcpc vrací strojově čitelný JSON. Výstup lze přímo skládat s jq:

mcpc --json @apify tools-call search-actors keywords:="scraper" \
  | jq '.content[0].text | fromjson | .items[0].id'

Tento přístup je klíčový pro efektivní integraci s AI agenty: agent nepotřebuje znát celou definici MCP serveru dopředu, ale může nástroje postupně objevovat přes grep a volat je jako kód přes Bash().

Přihlašovací údaje jsou uloženy v OS keychain (nikdy na disk). mcpc podporuje OAuth 2.1 s PKCE, automatické obnovování tokenů a přepínání mezi více účty přes OAuth profily.

Podporované metody autentizace:

• Anonymní přístup (veřejné servery)
• Bearer tokeny (přes flag –header, uložené jen pro danou session)
• OAuth 2.1 s plnou registrací klienta
• x402 platby (viz níže)

Místo načtení všech nástrojů do kontextu najednou může agent použít grep k hledání relevantních nástrojů a načítat jejich definice postupně. To výrazně snižuje spotřebu tokenů a omezuje context rot – jeden ze tří přístupů, které autoři prezentují jako řešení problémů současných MCP klientů.

mcpc podporuje MCP async tasks – dlouhotrvající operace, které server spustí na pozadí. Klient může sledovat jejich průběh a výsledky načítat po dokončení.

mcpc connect --proxy

Proxy režim izoluje přihlašovací údaje před AI agentem. Agent komunikuje přes proxy, ale k samotným credentials nemá přístup – důležité pro bezpečné nasazení v sandboxovaných prostředích, kde kód agenta není plně důvěryhodný.

mcpc implementuje protokol x402 pro autonomní mikroplatby. Agenti mohou platit za přístup k MCP nástrojům kryptoměnou na Base blockchainu bez ručního zásahu. Klíče jsou uloženy s oprávněními 0600.

• OAuth tokeny uloženy výhradně v OS keychain, nikdy na disk
• Credentials předávány přes Unix socket IPC, ne přes prostředí
• HTTPS vynuceno pro vzdálené servery
• OAuth callback vázán pouze na localhost
• x402 wallet klíče s oprávněním 0600
• Credentials nejsou logovány ani ve verbose režimu

Jan Curn z Apify projekt představil na Vibecoding Talks 20. dubna 2026 s tezí: „CLI is better than MCP“ je falešná dichotomie. Správná odpověď je MCP + CLI – využít standardizovaný protokol pro vzdálený přístup a shell jako lokální rozhraní agenta. Apify chce mcpc darovat Agentic AI Foundation jako zárodek oficiálního SDK pro shell, které dosud v MCP ekosystému chybí.

• mcpc na GitHubu (apify/mcpc)
• Apify – autoři projektu
• x402 payment protocol
• Vibecoding Talks, 20. 4. 2026 – Jan Curn (@jancurn), Apify