swarm repositories / source
aboutsummaryrefslogtreecommitdiff

libmcp

Industrial MCP hardening spine.

libmcp is the shared operational substrate extracted from long-lived MCP servers. It owns:

  • typed replay and fault contracts
  • JSON-RPC frame and request identity helpers
  • durable host-session kernel and snapshot-file handoff
  • model-facing rendering doctrine, especially porcelain-by-default output
  • normalization utilities for model input friction
  • standard health and telemetry payloads
  • JSONL operational telemetry
  • hardening test support

This repository is also the canonical owner of the $mcp-bootstrap Codex skill. The installed skill should be a symlink into this repository so the skill version tracks the library version and doctrine.

Status

libmcp 1.1.0 builds on the locked 1.0.0 base with a reusable host-session kernel, snapshot-file reexec handoff, a generic JSON-to-porcelain renderer, and a first fidget_spinner retrofit.

The eventual runtime-adapter and deeper client/server lift remain future work; this release does not pretend that phase is complete.

Layout

  • docs/spec.md: normative design and versioning contract
  • crates/libmcp: public library crate
  • crates/libmcp-testkit: shared hardening fixtures and assertions
  • assets/codex-skills/mcp-bootstrap: canonical skill source
  • scripts/link-codex-skills: installs the repo-owned skill into ~/.codex