Serveur MCP Handler
Commit 9 nov. 2026Permet aux clients IA et aux ingénieurs de se connecter, de communiquer avec et de gérer des agents A2A depuis un terminal ou une CLI.
Aussi connu sous alDuncanson/Handler
- Étoiles
- 47
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 9 nov. 2026
- Licence
- MIT
Qu'est-ce que Handler MCP ?
Handler est un serveur MCP. Permet aux clients IA et aux ingénieurs de se connecter, de communiquer avec et de gérer des agents A2A depuis un terminal ou une CLI.
Résumé généré à partir du README du projet
À propos du MCP server Handler
Handler permet aux ingénieurs logiciels qui construisent des systèmes agentiques de se connecter à des agents A2A et de les gérer directement depuis un terminal. Il offre la possibilité de communiquer avec les agents via une TUI interactive, une CLI scriptable avec des sorties structurées, ou en tant que MCP server permettant à d'autres agents de s'intégrer aux services A2A. Cet outil prend en charge diverses méthodes d'authentification, notamment les bearer tokens, les API keys, HTTP Basic, mTLS, OAuth2 client credentials et OpenID Connect.
Les utilisateurs peuvent interagir avec les agents en envoyant du texte, des fichiers via URL ou en ligne, ainsi que des données structurées. Le serveur gère le streaming des réponses, l'arrêt des tâches en cours et répond aux agents qui attendent une saisie. Il gère également le cycle de vie des tâches en permettant aux utilisateurs de les lister, de les inspecter, de les annuler et de s'y réabonner. Pour les développeurs ayant besoin de gérer les notifications, il inclut un récepteur de webhook local intégré pour gérer les configurations de notifications push.
Ce que vous pouvez faire avec
- 1Gérer les tâches des agents via le terminalDemandez à un client IA de lister ou d'annuler les tâches actives s'exécutant sur un serveur A2A.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblealduncanson/handler is public and reachablegithub.com/alduncanson/handler ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-09github.com/alduncanson/handler ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubHandler
Handler is an open-source A2A protocol client for software engineers building, testing, and operating agentic systems. It provides an interactive TUI, a scriptable CLI with structured output, and an MCP server that lets other agents integrate with A2A services directly. Handler also supports global and repo-scoped A2A server configuration with bearer, API key, HTTP Basic, mTLS, OAuth2 client credentials, and OpenID Connect auth.

Features
- Streams replies as they arrive, in the TUI and the CLI, and can stop a running task or answer an agent that pauses for input
- Sends text, files (inline or by URL), and structured data, and shows the file and data parts agents send back
- Lists, inspects, cancels, and resubscribes to tasks, and manages push notification configs with a bundled local webhook receiver
- Speaks JSON-RPC and HTTP+JSON out of the box, gRPC with the
grpcextra, and lets the agent card pick the transport - Requests A2A extensions and fetches the extended card an agent offers to authenticated clients
- Keeps credentials on the origin you configured, never on a host an agent card happens to name
Install
Install Handler from the PyPI package as a uv tool:
uv tool install a2a-handler
Or with pipx:
pipx install a2a-handler
Or with pip:
pip install a2a-handler
Quick Start
Open the interactive terminal UI:
handler tui
Inspect an A2A server's agent card:
handler card get --url http://localhost:8000
Send a message from the CLI:
handler message send --url URL --text "hello"
Stream the reply, with a file attached:
handler message stream --url URL --text "Review this" --file ./report.pdf
List the agent's tasks:
handler task list --url URL
Open the full documentation:
handler docs
Run Without Installing
Run Handler with uvx:
uvx --from a2a-handler handler
Run Handler with pipx:
pipx run a2a-handler
Documentation
Read the documentation at https://handler.alduncanson.com.
For coding agents
The docs ship as an agent skill, regenerated on every deploy. Install it into
Claude Code, Cursor, Windsurf, or any agent that reads the SKILL.md format:
npx skills add https://handler.alduncanson.com
Or fetch it by hand from https://handler.alduncanson.com/skill.md. For live lookups, agents can also use the hosted documentation MCP server at https://handler.alduncanson.com/mcp or the page index at https://handler.alduncanson.com/llms.txt. See the agent skill guide.
Questions sur Handler MCP
Qu'est-ce que Handler ?
Handler est un client de protocole A2A open-source doté d'une TUI interactive, d'une CLI scriptable et d'un MCP server.
Quelles méthodes d'authentification Handler prend-il en charge ?
Il prend en charge les bearer tokens, les API keys, HTTP Basic, mTLS, OAuth2 client credentials et OpenID Connect.
Comment installer Handler ?
Installez-le depuis PyPI en tant qu'outil uv, avec pipx ou avec pip.
Comment inspecter la carte d'agent d'un serveur A2A ?
Exécutez la commande card get avec l'URL du serveur.
Quels transports Handler prend-il en charge ?
Il utilise JSON-RPC et HTTP+JSON par défaut, gRPC avec l'extension grpc, et peut laisser la carte d'agent choisir.