flow-codeblock-mcp

Servidor stdio MCP local y Codex Skill para flowcodeblock. El MCP solo invoca la API REST en Rust de Flow Codeblock y no ejecuta el JavaScript del usuario en el equipo del usuario; el código del usuario sigue siendo ejecutado por el Supervisor Bun de la plataforma, entre del servidor.

Instalación

Requiere Bun 1.4.0 o superior:

bunx --bun flow-codeblock-mcp@0.2.6

Configuración obligatoria:

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

FLOW_CODEBLOCK_BASE_URL es la dirección de la API REST de Rust de Flow Codeblock desplegada. Para la pestaña pública se usa https://qingcode.oalite.com; solo si el usuario ha implementado el servicio Rust en su propia máquina, se recomienda cambiarlo a la dirección localhost correspondiente. El token debe configurarse mediante las variables de entorno del cliente o el Gestor de secretos, y no debe escribirse en el prompt, en los parámetros de la herramienta ni en archivos públicos.

Related MCP server: MCP QuickJS Runner

Configuración general de 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>"
      }
    }
  }
}

El paquete npm incluye el código fuente de ejecución del MCP, la Skill flow-codeblock, AGENT_PROMPT.md, las reglas de los modos módulo y peligroso, y el Schema de documentación de la interfaz. Los clientes MCP normales no instalan automáticamente la Skill de Codex, pero flow_write_code lee directamente las reglas autorizadas del paquete, por lo que se obtiene el contrato de código completo sin depender de la inyección de la Skill.

Confirmaciones de uso

• Antes de escribir código se llama a flow_write_code; en el modo no‑script se lee de input.<字段>, y en el modo script de input.query/header/body/cookies.

• Para crear o actualizar un script, primero hay que llamar a flow_preview_script_change, mostrar la vista previa al usuario y, después de obtener su confirmación explícita, llamar a flow_apply_script_change.

• El cliente que hace el POST del script envía directamente el JSON de negocio, sin envolverlo como input ni input.body.

• El MCP no proporciona una herramienta para eliminar scripts; el borrado debe hacerlo el usuario manualmente desde la página web o mediante la API REST.

• La ejecución de operaciones incluye con normalidad autenticación, límite de peticiones, descuento de cuotas, validaciones de seguridad, estadística y auditoría.