Cybernetic Amcp

Cybernetic aMCP

Distributed AI coordination framework for Elixir, built around Stafford Beer's Viable System Model. Combines AMQP messaging, CRDTs, MCP tool integration, and multi-provider LLM routing into a single OTP application.

Status

Metric	Value
Version	0.1.0
Elixir	>= 1.18
Runtime deps	34
Modules (.ex)	218
Test files	96
CI	GitHub Actions -- last run failed (Jan 2026, CI/CD Pipeline)
Database	PostgreSQL (required)
Message broker	RabbitMQ (required)
Test coverage threshold	24% (configured in mix.exs)

What it does

Implements a 5-layer VSM architecture as OTP processes with AI agent coordination:

Layer	Role	Key modules
System 1	Operations	Task execution, worker processes
System 2	Coordination	Anti-oscillation, load balancing
System 3	Control	Resource management, optimization
System 4	Intelligence	LLM routing, environment scanning
System 5	Policy	Governance, strategic direction

Cross-cutting infrastructure:

• AMQP transport -- RabbitMQ with publisher pools, causality tracking, topology management
• CRDT state -- Distributed context graphs via delta_crdt
• MCP integration -- Hermes MCP client for tool protocol
• LLM providers -- Multi-provider routing via req_llm (Anthropic, OpenAI, Together, Ollama)
• Edge gateway -- Phoenix-based HTTP API with rate limiting, circuit breakers, OIDC
• Security -- Bloom filter replay protection, Argon2 hashing, JWT/JWKS verification
• Content pipeline -- Connectors for WordPress, Drupal, Ghost, Sanity, Strapi, Contentful, Google Drive
• Observability -- OpenTelemetry, Prometheus (prom_ex), LiveDashboard
• Archeology tools -- Static/dynamic analysis, system tracing, overlay tool

Setup

Requires PostgreSQL, RabbitMQ, and Redis.

git clone https://github.com/jmanhype/cybernetic-amcp
cd cybernetic-amcp
cp .env.example