agent-chat-mcp 1.0.0

Agent Chat Room MCP server - Allows multiple Claude Code agents to communicate with each other

Agent Chat Room MCP Server

Birden fazla Claude Code agent'ının birbirleriyle iletişim kurmasını sağlayan MCP sunucusu. Dosya tabanlı paylaşımlı sohbet odası ile agent'lar mesaj gönderip alabilir.

Ozellikler

• Multi-room destegi: Agent'lar farkli odalarda calisabilir, config degistirmeden room parametresiyle gecis yapar
• Paylasimlı sohbet odası (dosya tabanlı, tüm agent'lar aynı odayı görür)
• Broadcast ve direct mesajlaşma
• Agent katılım/ayrılma takibi
• Mesaj önceliklendirme (urgent/normal/low)
• Stale agent temizleme (5 dk inaktif)
• Thread-safe dosya okuma/yazma (fcntl lock)
• Admin/manager için tüm mesajları okuma

Kurulum

Option 1: Using uvx (Recommended)

{
  "mcpServers": {
    "agent-chat": {
      "command": "uvx",
      "args": ["agent-chat-mcp"],
      "env": {
        "AGENT_CHAT_DIR": "/tmp/agent-chat-room",
        "AGENT_CHAT_ROOM": "default"
      }
    }
  }
}

Option 2: Install from Source

cd agent-chat
pip install -e .

Environment Variables

Degisken	Varsayilan	Aciklama
AGENT_CHAT_DIR	/tmp/agent-chat-room	Mesaj ve agent verilerinin saklanacagi dizin
AGENT_CHAT_ROOM	default	Varsayilan oda adi (tool parametresiyle override edilebilir)

Araclar (Tools)

join_room

Sohbet odasina katil. room parametresi ile farkli odalara katilinabilir.

{"agent_name": "backend", "role": "Backend API Developer", "room": "backend-team"}

send_message

Mesaj gonder (broadcast veya direct).

{
  "from_agent": "backend",
  "content": "API endpoint'leri hazir",
  "to_agent": "frontend",
  "expects_reply": true,
  "priority": "normal",
  "room": "backend-team"
}

read_messages

Yeni mesajlari oku.

{"agent_name": "frontend", "since_id": 5, "unread_only": true, "limit": 10, "room": ""}

list_agents

Odadaki agent'lari listele.

{"agent_name": "backend", "room": "backend-team"}

leave_room

Odadan ayril.

{"agent_name": "backend", "room": "backend-team"}

read_all_messages

Tum mesajlari oku (admin/manager icin).

{"since_id": 0, "limit": 15, "room": ""}

get_last_message_id

Son mesaj ID'sini al (polling icin).

{"agent_name": "backend", "room": ""}

list_rooms

Mevcut odalari ve agent/mesaj sayilarini listele.

{}

clear_room

Odayi temizle (tum mesajlar ve agent kayitlari silinir).

{"room": "backend-team"}

Kullanim Senaryosu

Multi-Agent Gelistirme (Tek Oda)

3 farkli Claude Code instance'i (terminal) acin:

Terminal 1 - Backend Agent:

join_room agent_name="backend" role="Backend API Developer"
send_message from_agent="backend" content="REST API endpointleri hazir, /api/users ve /api/posts"

Terminal 2 - Frontend Agent:

join_room agent_name="frontend" role="Frontend React Developer"
read_messages agent_name="frontend"
send_message from_agent="frontend" to_agent="backend" content="users endpoint'inde pagination var mi?"

Terminal 3 - Manager Agent:

join_room agent_name="manager" role="Project Manager"
read_all_messages

Multi-Room Kullanimi

Agent'lar MCP config'i degistirmeden farkli odalara gecis yapabilir:

# Varsayilan odaya katil
join_room agent_name="backend" role="Backend Dev"

# Farkli bir odaya da katil
join_room agent_name="backend" role="Backend Dev" room="design-review"

# Farkli odalara mesaj gonder
send_message from_agent="backend" content="API hazir" room="default"
send_message from_agent="backend" content="UI feedback'im var" room="design-review"

# Mevcut odalari listele
list_rooms

Nasil Calisiyor

• Her oda AGENT_CHAT_DIR/<room_name>/ altinda ayri dizinde saklanir
• Her odanin kendi messages.json ve agents.json dosyasi vardir
• room parametresi bos birakilirsa AGENT_CHAT_ROOM env degeri kullanilir (varsayilan: default)
• fcntl file locking ile thread-safe okuma/yazma
• 5 dakika inaktif agent'lar otomatik temizlenir
• expects_reply: false ile sonsuz mesaj dongusu onlenir

License

MIT