mcp-v8
mcp-v8 — MCP-сервер сообщества (автор — r33drichards). Запуск JavaScript и TypeScript в изолированных V8 с контролем возможностей. Лицензия AGPL-3.0.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- r33drichards
- Лицензия
- AGPL-3.0
- Транспорт
- stdio
- Авторизация
- none
- ОС
- linux, macos
- Языки
- rust
Уровень риска: high
Выполняет код JavaScript/TypeScript в песочнице V8; сеть, файлы и подпроцессы выключены по умолчанию и открываются политиками Rego; снимки кучи пишутся на диск или в S3.
Настройка клиентов
{
"code": "# Claude Code (stdio)\nclaude mcp add mcp-v8 -- mcp-v8 --directory-path /tmp/mcp-v8-heaps # stateful\nclaude mcp add mcp-v8 -- mcp-v8 --stateless # stateless",
"lang": "bash",
"verified": "docs"
}
Что умеет
mcp-v8 — проект сообщества на Rust: MCP-сервер, который позволяет ИИ-агенту запускать JavaScript и TypeScript в изолированном движке V8. Вместо десятков узких инструментов агент получает один — run_js — и пишет код: циклы, ветвления, преобразование данных, вызовы других инструментов. Часто это занимает заметно меньше токенов, чем цепочки вызовов инструментов.
Состояние между вызовами. В режиме по умолчанию (stateful) куча V8 сохраняется как снимок с адресацией по содержимому — в локальной файловой системе, S3 или S3 с кешем, — и агент накапливает состояние за много шагов. Есть и режим без состояния (--stateless).
Безопасность по умолчанию. Сеть (fetch), файловая система, подпроцессы, импорт внешних модулей и вызовы других MCP-серверов выключены и включаются только явными политиками OPA/Rego, которые проверяются для каждой операции. По желанию весь процесс можно ограничить на уровне ядра через --sandbox-manifest (Landlock в Linux, Seatbelt в macOS).
Возможности:
- JavaScript и TypeScript (типы удаляются через SWC, без проверки), async/await и таймеры.
- Захват консоли с постраничным чтением вывода; асинхронное выполнение с ID, опросом статуса и отменой.
- WebAssembly, в том числе заранее загруженные модули.
- Импорт
npm:,jsr:и URL-модулей по политике. - Вызов других MCP-серверов из кода через
mcp.callTool()иmcp.listTools(), включая OAuth для защищённых серверов. - Транспорты stdio, потоковый HTTP и устаревший SSE, REST-эндпоинт
/api/execсо спецификацией OpenAPI. - Проверка JWT через JWKS и кластеризация на Raft для горизонтального масштабирования; поддержка расширения MCP tasks для долгих вызовов.
Инструменты: run_js, а в режиме с состоянием ещё get_execution, get_execution_output, cancel_execution, list_executions, list_sessions, list_session_snapshots и инструменты тегов снимков кучи.
Кому подойдёт
- Разработчикам агентов, которым нужен «режим кода» вместо множества инструментов.
- Командам платформ, разворачивающим общую песочницу для выполнения кода.
Похожие серверы — в категории разработка.
Установка
Сервер ставится скриптом из репозитория в /usr/local/bin (Linux x86_64 и arm64, macOS на Apple Silicon); также доступны nix run github:r33drichards/mcp-js, Docker Compose, сборка из исходников и развёртывание на Railway. HTTP-режим: mcp-v8 --stateless --http-port 8080, адрес MCP — /mcp. Все флаги можно собрать в одном TOML- или JSON-файле через --config.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
# Claude Code (stdio)
claude mcp add mcp-v8 -- mcp-v8 --directory-path /tmp/mcp-v8-heaps # stateful
claude mcp add mcp-v8 -- mcp-v8 --stateless # statelessДля Claude Code выберите одну из двух команд: с сохранением состояния или без. Тот же JSON, что для Claude Desktop, подходит для Cursor.
Проверка
Попросите агента выполнить console.log([1,2,3].map(x => x*2)) — должен вернуться массив [2, 4, 6].
Примеры задач
Напиши и выполни скрипт, который сгруппирует этот JSON по полю status и посчитает итоги.Продолжи вычисления в той же сессии, используя переменные из прошлого шага.Риски
- Выполнение произвольного кода, который пишет модель. По умолчанию он изолирован в V8.
- Расширенные возможности по политике: сеть, файлы и подпроцессы. Выдавайте их точечно и проверяйте политики Rego.
- Снимки кучи хранят данные сессий на диске или в S3.
Частые вопросы
Есть ли у кода доступ к сети по умолчанию?
Нет, только по явной политике.
Сохраняется ли состояние?
Да, в режиме с состоянием через снимки кучи.
Поддерживается ли TypeScript?
Да, типы удаляются перед выполнением.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.