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.

Настройка клиентов

claude-code
{
    "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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники