@ovanek/mcp
v1.0.0
Published
Ovanek MCP — Model Context Protocol (stdio) server exposing the Ovanek platform tools. Write tools are dry-run by default.
Maintainers
Readme
Ovanek MCP
A hand-rolled Model Context Protocol server (JSON-RPC 2.0 over stdio,
protocol version 2025-06-18) exposing the Ovanek platform's tools.
- Read tools query the platform API and the ERC-8004 registries. They aim at
whatever
ACM_BASE_URLpoints to (defaulthttp://127.0.0.1:5000). - Write tools are DRY-RUN BY DEFAULT — they return the exact payload they
would send, to nowhere. A real write requires
MCP_ALLOW_WRITES=1and a localACM_BASE_URL; writes against a remote deployment are refused unless the operator also setsMCP_ALLOW_REMOTE_WRITES=1. - No key material lives in this process. Sign with the Ovanek SDK
(
@ovanek/sdk) and pass the finished signature in.
Environment
| Var | Meaning |
|---|---|
| ACM_BASE_URL | Platform base URL (default local dev server). |
| MCP_ALLOW_WRITES | 1 allows dryRun: false writes. |
| MCP_ALLOW_REMOTE_WRITES | 1 allows writes against a non-local ACM_BASE_URL. |
| MCP_SERVER_INVOKED | Set 0 to import the module without starting the stdio loop (test seam). |
Run from source
NODE_OPTIONS="--dns-result-order=ipv4first" \
npx tsx --conditions=react-server mcp/server.tsBuild / pack
prepack bundles mcp/server.ts (with the SDK inlined) to
dist/server.js, which carries a #!/usr/bin/env node shebang and is exposed
as the ovanek-mcp bin.
npm run build --prefix mcp # or: node ../scripts/build-package.mjs mcp
npm pack ./mcp --dry-runviem is a peer dependency. Not published — see the repository root
README.md.
