flow-codeblock-mcp

Flow Codeblock의 로컬 stdio MCP Server 및 Codex Skill. MCP는 Flow Codeblock Rust REST API만 호출하며, 사용자 컴퓨터에서 사용자 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은 배포된 Flow Codeblock Rust API 주소입니다. 공개 서비스에서는 https://qingcode.oalite.com을 사용하며, 사용자가 본인 컴퓨터에 Rust 서비스를 배포한 경우에만 해당 localhost 주소로 변경합니다. Token은 클라이언트의 환경 변수 또는 비밀 키 설정을 사용해야 하며, 프롬프트, 도구 인자 또는 공개 파일에 작성하면 안 됩니다.

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-codeblock Skill, AGENT_PROMPT.md, 모듈/위험 모드 규칙 및 인터페이스 문서 Schema가 포함되어 있습니다. 일반 MCP 클라이언트는 Codex Skill을 자동으로 설치하지 않지만, flow_write_code가 패키지 내부의 표준 규칙을 직접 읽으므로 Skill 주입에 의존하지 않아도 완전한 코드 계약을 얻을 수 있습니다.

사용 제약

• 코드를 작성하기 전에 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를 통해 직접 처리해야 합니다.

• 실행 작업은 인증, 속도 제한, 할당량 차감, 보안 검증, 통계 및 감사를 정상적으로 수행합니다.