Agentic Framework

Agentic Framework

MCP-based communication framework enabling multiple AI agents to collaborate through asynchronous messaging.

4
Stars
1
Forks
0
Releases

Overview

The MCP Agentic Framework provides an MCP-based backbone for multi-agent collaboration via asynchronous messaging. It supports dynamic runtime registration of agents with unique identities, discovery of peers, and bidirectional message exchange, enabling complex task collaboration across multiple agents (e.g., Claude agents or other MCP-compatible agents). In addition to direct messaging, the framework supports broadcasting messages to all registered agents, with optional priority tagging. A lightweight, file-based storage layer ensures portability and ease of use, storing registered agents and messages under /tmp/mcp-agentic-framework (agents.json and messages/*.json) for persistence without external dependencies. HTTP transport is available for integration with Claude Desktop/Claude Code and other MCP clients, exposing endpoints such as /mcp for communication and /health for status. Server-Sent Events (SSE) are supported to provide real-time updates over HTTP. The package exposes a suite of management tools (register-agent, unregister-agent, discover-agents) and messaging operations (send-message, check-for-messages, get-pending-notifications, send-broadcast, update-agent-status). Deployment guidance includes Kubernetes readiness and Just-based workflows, highlighting a portable, test-driven, and runtime-configurable environment for distributed agent collaboration.

Details

Owner
Piotr1215
Language
JavaScript
License
Updated
2025-12-07

Features

Dynamic agent registration and identity management

Agents can register at runtime with unique names and descriptions, enabling flexible, evolving collaboration without static configuration.

Agent discovery and roster

Provides an up-to-date list of registered agents and their statuses for dynamic coordination.

Asynchronous messaging with per-agent queues

Agents exchange messages asynchronously, with each agent maintaining a private message queue and persistent history stored locally.

Direct messaging and read tracking

Supports sending messages between agents with timestamps and read status, enabling reliable delivery tracking.

Broadcast messaging with priority

Broadcast messages can be sent to all agents (excluding the sender) with priority tagging; recipient count is returned.

File-based storage for portability

All data is stored locally (agents.json and messages/*.json) under /tmp/mcp-agentic-framework for portability and offline operation.

HTTP transport with SSE and health endpoints

HTTP-based MCP transport with /mcp and /health endpoints; supports Server-Sent Events for real-time updates.

Audience

DevelopersBuild and orchestrate multi-agent workflows by registering, discovering, and messaging agents in a lightweight, portable backend.
ResearchersPrototype and test agent coordination, negotiation, and collaboration strategies in a controlled environment.
Claude integration developersIntegrate Claude or other MCP-compatible agents via HTTP transport and SSE for real-time updates within Claude Desktop or Code setups.

Tags

MCPmulti-agentasynchronous messagingagent registrymessage queuefile-based storageHTTP transportSSEbroadcastdiscoveryhealth