Mcp Client

CLI per elencare e chiamare tool su qualsiasi server MCP senza caricare tutti gli schemi nel contesto

di coleam00 · coleam00/second-brain-skills

Promosso ★ 9.2/10

Mcp Client — CLI per elencare e chiamare tool su qualsiasi server MCP senza caricare tutti gli schemi nel contesto

Cosa fa

Un client MCP universale da riga di comando che si connette a qualsiasi server MCP configurato (stdio, SSE, HTTP streamabile o FastMCP/Bearer), elenca i tool di un server con schemi di parametri completi ed esegue chiamate di tool, caricando gli schemi su richiesta invece di riversarli nella finestra di contesto. Si attiva quando l'utente chiede di connettersi a un server MCP, elencare tool MCP o chiamare un'azione MCP (Zapier, sequential-thinking, GitHub, filesystem, ecc.). La configurazione si risolve da una variabile d'ambiente, dalla cartella dei riferimenti della skill, da .mcp.json o da ~/.claude.json.

Rapporto di test

Clonato in una HOME temporanea, installato mcp+fastmcp in un venv e eseguito il client contro un vero server stdio (@modelcontextprotocol/server-sequential-thinking). Tutti e tre i sottocomandi hanno funzionato: servers ha restituito la voce configurata, tools ha restituito il tool sequentialthinking con schema JSON completo, e call ha eseguito il tool e restituito il suo risultato JSON; un nome server sconosciuto ha restituito {"type":"validation"}. Baseline: uno script di 14 righe scritto a mano elencava solo i nomi dei tool per un server stdio hardcoded; il singolo comando della skill rileva automaticamente 4 trasporti, risolve la configurazione da 4 posizioni di fallback e restituisce schemi completi più un percorso di chiamata. Tutti e 4 i file referenziati hanno recuperato HTTP 200; il frontmatter è stato analizzato con name+description; nessun problema di sicurezza (solo menzioni benigne di "subprocess" nella documentazione).

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/coleam00/second-brain-skills.git /tmp/mcp-client-src
mkdir -p ~/.claude/skills
cp -R /tmp/mcp-client-src/.claude/skills/mcp-client ~/.claude/skills/mcp-client
# Python deps required to run the client:
#   pip install mcp fastmcp
# Configure servers by editing ~/.claude/skills/mcp-client/references/mcp-config.json
#   (template at references/example-mcp-config.json), or set MCP_CONFIG_PATH / MCP_CONFIG,
#   or rely on an existing .mcp.json / ~/.claude.json.
# Usage:
#   python ~/.claude/skills/mcp-client/scripts/mcp_client.py servers
#   python ~/.claude/skills/mcp-client/scripts/mcp_client.py tools <server>
#   python ~/.claude/skills/mcp-client/scripts/mcp_client.py call <server> <tool> '{"arg":"value"}'

Comandi e prompt di esempio

/mcp-clientCLI per elencare e chiamare tool su qualsiasi server MCP senza caricare tutti gli schemi nel contesto

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Connect to the Zapier MCP server and list tools
Call the GitHub MCP server to list open PRs
Use sequential thinking via MCP to solve this

Rapporto completo →