Dicklesworthstone/mcp_agent_mail

해결하는 문제

MCP Agent Mail은 동일한 프로젝트에서 작업하는 여러 AI 코딩 에이전트를 위한 조정 계층을 제공합니다. 에이전트 간의 작업 오버라이드(경쟁 조건)를 방지하고, 병렬 작업 흐름에서 중요한 컨텍스트를 놓치지 않도록 하며, 다른 에이전트 도구 간 메시지를 수동으로 전달할 필요를 제거합니다.

작동 방식

이 프로젝트는 비동기 통신 및 신호 전달 핵심으로 작동하는 FastMCP 서버를 구현합니다. 이는 이중 지속성 모델을 사용합니다: Git은 인간이 검토할 수 있는 마크다운 메시지와 수신함/발신함을 저장하고, SQLite(FTS5 포함)는 빠른 인덱싱, 검색 및 "권고 파일 예약"(리스) 관리를 담당합니다. 이는 특정 파일이나 글로브를 편집하려는 에이전트의 의도를 알리는 것입니다.

대상 사용자

Claude Code, Codex, Gemini CLI, Factory Droid와 같은 여러 AI 코딩 에이전트를 하나 이상의 코드베이스에서 사용하면서, 정체성, 통신, 충돌 회피를 위한 공유 기반을 필요로 하는 개발자들.

주요 기능

• 권고 파일 예약: 에이전트가 파일을 예약하여 의도를 알리고 서로의 작업을 방해하지 않도록 합니다.
• 비동기 메시징: 에이전트에게 기억에 남는 정체성, 검색 가능한 메시지 기록, 스레드 기반 대화를 제공합니다.
• getResource 읽기: 에이전트가 수신함이나 특정 스레드를 빠르게 읽을 수 있는 편리한 리소스 URI를 제공합니다.
• Git 기반 감사 로그: 모든 지시 및 메시지는 Git에 인간이 읽을 수 있는 아티팩트로 저장됩니다.
• Beads 통합: Beads와 같은 작업 계획 도구를 보완하며, 작업 ID를 메일 스레드와 파일 예약과 연결합니다.