mcp-v8¶
mcp-v8 is a Rust-based MCP server that exposes a V8 JavaScript runtime to AI
agents and other clients. It supports stateful and stateless execution,
multiple transports, JavaScript and TypeScript execution, full async/await and
Promise support via the deno_core event loop, optional policy-gated network
and filesystem access, and content-addressed heap persistence.
mcp-v8 is designed for cases where agents need real compute and controlled
access to host resources, but the cost of a full Linux VM is too high. It adds
a policy layer between the JavaScript runtime and the underlying machine so you
can expose network, filesystem, and other capabilities with tighter control and
lower overhead than VM or container-based approaches.
Quick Start¶
If you want the fastest path to a working setup, start with
Quick Start. It includes entry points for Claude Code,
Codex, Cursor, generic MCP clients, curl, and the bundled CLI.
Use this documentation by intent:
- Start with Quick Start if you need orientation.
- Use How-to when you need to complete a task.
- Read Concepts to understand system behavior.
- Use Reference for flags, APIs, and interface details.
What this site covers¶
- how to install and run the server
- how transports and execution modes differ
- how JavaScript and TypeScript run in the runtime
- how async JavaScript behaves in the runtime event loop
- how sessions, heaps, and clustering work
- how policy-gated fetch, filesystem access, and module loading behave
- how to use the HTTP API