Run Yukh MCP locally

Yukh MCP gives agents typed, policy-governed capabilities without exposing credentials or unrestricted shell access.

Foundation

Yukh MCP is not production-ready. The ordinary gateway is inert. The supported demo uses only synthetic local data and in-memory evidence.

Requires Node.js 22 or newer:

npm ci --ignore-scripts
npm run demo:e2e

The command needs no credentials or configuration. It uses a real MCP client over an ephemeral loopback HTTP port, runs one allowed node.inspect request and one denial, cleans up, then exits.

Run the demo Understand the architecture

Choose a path

• Evaluate it: run the read-only demo.
• Inspect the process: start the inert gateway.
• Publish agent work: follow the agent GitHub workflow.
• Integrate contracts: use the contract reference.
• Model distributed activity: read the event and subject policy.
• Review safety: read the security model.

Current boundary

Available today:

• versioned capability and authorization contracts;
• network-free validators and fixtures;
• an inert MCP Streamable HTTP gateway;
• a synthetic node.inspect demo.

Not available:

• production deployment;
• real credentials or targets;
• operational tools on the ordinary gateway;
• persistent audit storage;
• mutating capabilities.