zkzkMCP
Getting started

Installation

Install the zkMCP monorepo and verify the local toolchain.

Clone and install

 git clone https://github.com/zohaibarsalan/zkMCP.git
 cd zkMCP
 npm install

The project uses a single npm workspace and root lockfile.

Verify the toolchain

node --version
docker --version
docker compose version
compact --version
compact compile --version

The validated local stack uses:

ComponentVersion used by the prototype
Node.js22+
Compact compiler0.31.1
Midnight.js4.1.1
Midnight proof server8.1.0
MCP TypeScript SDK2.0.0
Next.js16.3.3

Code quality

Run the repository-wide quality gate at any time:

npm run foundation:check

It runs Ultracite/Biome, TypeScript checks, package tests, and Compact compilation.

Generated and private state

The following local artifacts are intentionally gitignored:

.evlog/
authorization-state/
midnight-level-db/
.midnight-state.json
.midnight-wallet-state/
.zkmcp-policy.json

Do not copy these files into logs, bug reports, or public artifacts without inspecting them first.

On this page