# VSMCP

> Viable System Model Cybernetic Platform - Elixir implementation with AMQP, MCP, and CRDT support

- **Type:** MCP server
- **Install:** `agentstack add mcp-jmanhype-vsmcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jmanhype](https://agentstack.voostack.com/s/jmanhype)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jmanhype](https://github.com/jmanhype)
- **Source:** https://github.com/jmanhype/VSMCP

## Install

```sh
agentstack add mcp-jmanhype-vsmcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# VSMCP

Elixir implementation of Stafford Beer's Viable System Model (VSM) with MCP integration, AMQP messaging, and CRDT-based distributed state.

## Status

Early-stage (v0.1.0). Core supervision tree runs. No hex.pm release exists despite badge placeholders in the previous README. The CI badge pointed to a `viable-systems` org that does not match this repo's owner. Test coverage is unknown.

## What It Does

Maps Beer's 5 VSM subsystems onto an OTP application:

| VSM System | Role | Elixir Module |
|---|---|---|
| System 1 (Operations) | Autonomous work units, MCP tool execution | `Vsmcp.Systems.System1` |
| System 2 (Coordination) | Conflict resolution, anti-oscillation | `Vsmcp.Systems.System2` |
| System 3 (Control) | Resource allocation, audit channel (3*) | `Vsmcp.Systems.System3` |
| System 4 (Intelligence) | Environment scanning, MCP server discovery | `Vsmcp.Systems.System4` |
| System 5 (Policy) | Identity, governance, goal alignment | `Vsmcp.Systems.System5` |

Additional subsystems:

| Component | Purpose |
|---|---|
| AMQP Nervous System | RabbitMQ message routing between VSM layers |
| CRDT Store | Conflict-free replicated data types (OR-Set, G-Counter, LWW-Register, HLC) |
| MCP Server/Client | Model Context Protocol for dynamic tool discovery |
| Consciousness Interface | Meta-cognitive reflection layer |
| Variety Calculator | Ashby's Law of Requisite Variety metrics |

## Tech Stack

| Layer | Technology |
|---|---|
| Language | Elixir 1.17+ / OTP 26+ |
| Messaging | RabbitMQ 3.13+ (AMQP) |
| State | CRDT (custom), optional PostgreSQL 14+ |
| Protocol | MCP (TCP, WebSocket, stdio transports) |
| Deployment | Docker, Kubernetes (manifests in `k8s/`) |
| Telemetry | OpenTelemetry-compatible, Prometheus on port 9568 |

## Project Layout

```
lib/vsmcp/
  systems/          # System 1-5 implementations
  amqp/             # Connection pool, channel manager, consumers, producers
  crdt/             # OR-Set, G-Counter, LWW-Register, HLC, storage
  mcp/              # Server, client, protocol, capability/tool registries
  consciousness/    # Meta-cognitive interface
  core/             # Variety calculator
config/             # dev.exs, runtime.exs, test.exs
k8s/                # Kubernetes base + production overlay
examples/           # Demo scripts (AMQP, Hermes MCP, Telegram VSM)
```

## Setup

```bash
git clone https://github.com/jmanhype/VSMCP.git
cd VSMCP
mix deps.get && mix compile
mix test
iex -S mix
```

Docker:

```bash
docker build -t vsmcp .
docker run -p 4010:4010 vsmcp
```

Kubernetes:

```bash
kubectl apply -f k8s/base/
```

## Configuration

Key environment variables:

| Variable | Default | Purpose |
|---|---|---|
| `VSMCP_MCP_PORT` | 4010 | MCP server port |
| `VSMCP_MCP_TRANSPORT` | tcp | tcp, websocket, or stdio |
| `VSMCP_AMQP_URL` | amqp://localhost:5672 | RabbitMQ connection |
| `VSMCP_AMQP_POOL_SIZE` | 10 | Connection pool size |
| `VSMCP_METRICS_PORT` | 9568 | Prometheus metrics |
| `VSMCP_LOG_LEVEL` | info | debug, info, warn, error |

See `config/config.exs` for full tuning parameters (variety check intervals, recursion depth, prefetch counts, timeouts).

## Limitations

- No published hex package. The old README badges were aspirational.
- Telegram bot integration exists in `examples/` but the polling system had known issues (see `TELEGRAM_POLLING_INVESTIGATION_REPORT.md`).
- The "consciousness interface" is a structural placeholder, not an AI cognition system.
- CRDT implementation is custom and not benchmarked against established libraries like Delta-CRDT.
- No integration tests for the full AMQP nervous system path.

## License

See `LICENSE.md`.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jmanhype](https://github.com/jmanhype)
- **Source:** [jmanhype/VSMCP](https://github.com/jmanhype/VSMCP)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jmanhype-vsmcp
- Seller: https://agentstack.voostack.com/s/jmanhype
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.