MCP server Handler
Commit 9 de nov. de 2026Permite que clientes de IA e engenheiros se conectem, enviem mensagens e gerenciem agentes A2A através de um terminal ou CLI.
Também conhecido como alDuncanson/Handler
- Stars
- 47
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- —
- Último commit
- 9 de nov. de 2026
- Licença
- MIT
O que é o MCP Handler?
Handler é um MCP server. Permite que clientes de IA e engenheiros se conectem, enviem mensagens e gerenciem agentes A2A através de um terminal ou CLI.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Handler
Conectar-se e gerenciar agentes A2A a partir de um terminal é o que o Handler possibilita para engenheiros de software que constroem sistemas agênticos. Ele oferece uma maneira de se comunicar com agentes por meio de uma TUI interativa, uma CLI roteirizável com saída estruturada ou como um MCP server que permite que outros agentes se integrem a serviços A2A. Esta ferramenta suporta vários métodos de autenticação, incluindo bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials e OpenID Connect.
Os usuários podem interagir com agentes enviando texto, arquivos via URL ou inline e dados estruturados. O servidor gerencia respostas em stream, interrompe tarefas em execução e responde a agentes que pausaram aguardando entrada. Ele também gerencia o ciclo de vida das tarefas, permitindo que os usuários listem, inspecionem, cancelem e assinem novamente tarefas. Para desenvolvedores que precisam gerenciar notificações, ele inclui um receptor de webhook local integrado para lidar com configurações de push notification.
O que você pode fazer com ele
- 1Gerenciar tarefas de agentes via terminalPeça a um cliente de IA para listar ou cancelar tarefas ativas em execução em um servidor A2A.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelalduncanson/handler is public and reachablegithub.com/alduncanson/handler ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-09github.com/alduncanson/handler ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP Handler
O que é o Handler?
O Handler é um cliente de protocolo A2A de código aberto com uma TUI interativa, uma CLI roteirizável e um MCP server.
Quais métodos de autenticação o Handler suporta?
Ele suporta bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials e OpenID Connect.
Como eu instalo o Handler?
Instale via PyPI como um uv tool, usando pipx ou com pip.
Como eu inspeciono o agent card de um servidor A2A?
Execute o comando card get com a URL do servidor.
Quais transports o Handler suporta?
Ele utiliza JSON-RPC e HTTP+JSON por padrão, gRPC com o extra grpc, e permite que o agent card escolha o protocolo.