Mcp Client

CLI pour lister et appeler des outils sur n'importe quel serveur MCP sans charger tous les schémas en contexte

par coleam00 · coleam00/second-brain-skills

Testé · Fonctionne ★ 9.2/10

Mcp Client — CLI pour lister et appeler des outils sur n'importe quel serveur MCP sans charger tous les schémas en contexte

Ce que fait

Un client MCP universel en ligne de commande qui se connecte à n'importe quel serveur MCP configuré (stdio, SSE, HTTP streamable ou FastMCP/Bearer), liste les outils d'un serveur avec des schémas de paramètres complets, et exécute des appels d'outils, chargeant les schémas à la demande au lieu de les déverser dans la fenêtre de contexte. Il se déclenche lorsque l'utilisateur demande de se connecter à un serveur MCP, de lister les outils MCP ou d'appeler une action MCP (Zapier, sequential-thinking, GitHub, filesystem, etc.). La configuration est résolue à partir d'une variable d'environnement, du dossier de références de la compétence, de .mcp.json ou de ~/.claude.json.

Rapport de test

Cloné dans un HOME temporaire, installé mcp+fastmcp dans un venv, et exécuté le client contre un vrai serveur stdio (@modelcontextprotocol/server-sequential-thinking). Les trois sous-commandes ont fonctionné : servers a renvoyé l'entrée configurée, tools a renvoyé l'outil sequentialthinking avec le schéma JSON complet, et call a exécuté l'outil et renvoyé son résultat JSON ; un nom de serveur inconnu a renvoyé {"type":"validation"}. Référence : un script écrit à la main de 14 lignes listait uniquement les noms d'outils pour un serveur stdio codé en dur ; la seule commande de la compétence détecte automatiquement 4 transports, résout la configuration à partir de 4 emplacements de repli, et renvoie des schémas complets plus un chemin d'appel. Les 4 fichiers référencés ont renvoyé HTTP 200 ; le frontmatter est parsé avec name+description ; pas de problèmes de sécurité (seules des mentions bénignes de "subprocess" dans la documentation).

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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"}'

Commandes et exemples de prompts

  • /mcp-clientCLI pour lister et appeler des outils sur n'importe quel serveur MCP sans charger tous les schémas en contexte

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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