flow-codeblock-mcp

Локальный stdio MCP-сервер и Codex Skill для Flow Codeblock. MCP только вызывает Rust REST API Flow Codeblock и не выполняет пользовательский JavaScript на компьютере пользователя; код пользователя по-прежнему выполняется серверным Bun Supervisor фиксированной версии.

Установка

Требуется Bun 1.4.0 или выше:

bunx --bun flow-codeblock-mcp@0.2.6

Необходимо настроить:

FLOW_CODEBLOCK_BASE_URL=https://qingcode.oalite.com
FLOW_CODEBLOCK_TOKEN=flow_xxx

FLOW_CODEBLOCK_BASE_URL — это адрес развёрнутого Rust API Flow Codeblock. Для публичного сервиса используйте https://qingcode.oalite.com; только если пользователь развернул Rust-сервис на своей машине, замените его на соответствующий localhost-адрес. Токен следует задавать через переменные окружения или секреты клиента, не записывайте его в промпты, параметры инструментов или публичные файлы.

Related MCP server: MCP QuickJS Runner

Общая конфигурация stdio MCP

{
  "mcpServers": {
    "flow-codeblock": {
      "command": "bunx",
      "args": ["--bun", "flow-codeblock-mcp@0.2.6"],
      "env": {
        "FLOW_CODEBLOCK_BASE_URL": "https://qingcode.oalite.com",
        "FLOW_CODEBLOCK_TOKEN": "<YOUR_FLOW_CODEBLOCK_TOKEN>"
      }
    }
  }
}

npm-пакет содержит исходный код MCP, скилл flow-code block, AGENT_PROMPT.md, правила модулей/опасных режимов и схему интерфейсных документов. Обычные MCP-клиенты не устанавливают Codex Skill автоматически, но flow_write_code напрямую читает авторитетные правила из пакета, поэтому полный контракт кода доступен и без подключения скилла.

Пользователь и ограничения

• Перед написанием кода вызывайте flow_write_code; в не-скриптовом режиме читайте из input.<поле>, в режиме скрипта — из input.query/header/body/cookies.

• Перед созданием или обновлением скрипта сначала вызовите flow_preview_script_change, покажите предварительный просмотр пользователю и получите явное подтверждение, только затем вызывайте flow_apply_script_change.

• Вызывающая сторона POST для скриптов отправляет бизнес-данные сразу в формате JSON, не оборачивая их в input или input.body.

• MCP не предоставляет инструмент для удаления скриптов; удаление пользователь должен выполнить сам через веб-интерфейс или REST API.

• Каждая операция проходит аутентификацию, ограничение частоты, списание квоты, проверку безопасности, сбор статистики и аудит.