Dicklesworthstone/mcp_agent_mail

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

解決する課題

MCP Agent Mail は、同じプロジェクトで作業する複数のAIコーディングエージェントのための調整層を提供します。共有通信基盤、アイデンティティ管理、およびファイル予約を通じた意図のシグナル送信の仕組みにより、エージェント同士が作業を上書きしたり、重要なコンテキストを逃したりするのを防ぎます。

動作方法

このプロジェクトは、HTTPのみをサポートするFastMCPサーバーとして動作し、2つの永続化方法を組み合わせています:人間が確認可能なMarkdownメッセージにはGit、高速なインデックス作成、検索、ファイルリースの管理にはSQLiteを使用します。エージェントは一意のアイデンティティを登録でき、スレッド形式の会話でメッセージを送受信し、特定のファイルやワイルドカードに対して「推奨リース(leases)」を宣言して、現在その領域を編集中であることを示すことができます。

対象ユーザー

FastMCPクライアントやCLIツール(Claude Code、Codex、Gemini CLI、Factory Droidなど)を使用し、1つ以上のコードベースにまたがる多様なエージェントのチームを調整している開発者向けに設計されています。

主な特徴

  • 非同期調整:トークン予算を消費せずに、コンテキストを共有できる受信箱、送信箱、検索可能なメッセージ履歴を提供。
  • ファイル予約:エージェント同士が編集を重複しないようにするためのリースシステムを実装。
  • 二重永続化:監査ログにはGit、高性能なクエリにはSQLiteを使用。
  • エージェントディレクトリ:アクティブなアイデンティティ、プログラム、活動状況を確認できるディレクトリを提供。
  • Beadsとの統合:タスクの優先順位付けをコミュニケーションとファイルロックと一致させるために、Beads(タスクプランナー)と連携可能。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • Dispatch
  • Dispatch