Handler MCP server
2026년 11월 9일 커밋AI 클라이언트와 엔지니어가 터미널 또는 CLI에서 A2A 에이전트에 연결하고, 메시지를 주고받으며, 관리할 수 있도록 지원합니다.
다른 이름 alDuncanson/Handler
- 스타
- 47
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
Handler MCP란?
Handler은(는) MCP server입니다. AI 클라이언트와 엔지니어가 터미널 또는 CLI에서 A2A 에이전트에 연결하고, 메시지를 주고받으며, 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Handler MCP server 정보
Handler는 에이전트 기반 시스템을 구축하는 소프트웨어 엔지니어가 터미널에서 A2A 에이전트에 연결하고 관리할 수 있는 환경을 제공합니다. 대화형 TUI, 구조화된 출력을 지원하는 스크립트 가능 CLI, 그리고 다른 에이전트가 A2A 서비스와 통합할 수 있게 해주는 MCP server를 통해 에이전트와 통신할 수 있습니다. 이 도구는 bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials, OpenID Connect를 포함한 다양한 인증 방식을 지원합니다.
사용자는 텍스트, URL 또는 인라인 방식의 파일, 그리고 구조화된 데이터를 전송하여 에이전트와 상호작용할 수 있습니다. 서버는 스트리밍 응답 처리, 실행 중인 작업 중단, 입력을 기다리는 에이전트에 대한 응답 등을 처리합니다. 또한 사용자가 작업을 목록화, 조사, 취소 및 재구독할 수 있도록 작업 라이프사이클을 관리합니다. 알림 관리가 필요한 개발자를 위해 푸시 알림 설정을 처리할 수 있는 로컬 웹훅 수신기가 포함되어 있습니다.
활용 사례
- 1터미널을 통한 에이전트 작업 관리AI 클라이언트에 A2A server에서 실행 중인 활성 작업 목록을 요청하거나 작업을 취소하도록 명령할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능alduncanson/handler is public and reachablegithub.com/alduncanson/handler ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-09github.com/alduncanson/handler ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Handler
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.
Handler MCP 질문
Handler란 무엇인가요?
Handler는 대화형 TUI, 스크립트 작성이 가능한 CLI, 그리고 MCP server를 갖춘 오픈 소스 A2A 프로토콜 클라이언트입니다.
Handler는 어떤 인증 방식을 지원하나요?
bearer tokens, API keys, HTTP Basic, mTLS, OAuth2 client credentials, OpenID Connect를 지원합니다.
Handler를 어떻게 설치하나요?
PyPI에서 uv tool로 설치하거나, pipx 또는 pip를 사용하여 설치할 수 있습니다.
A2A server의 agent card를 어떻게 확인하나요?
서버 URL과 함께 card get 명령어를 실행하세요.
Handler는 어떤 전송 방식을 지원하나요?
기본적으로 JSON-RPC와 HTTP+JSON을 지원하며, grpc extra 사용 시 gRPC도 지원합니다. 또한 agent card가 전송 방식을 선택하도록 할 수도 있습니다.