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 を通じて自分で行う必要があります。

• 実行操作では、認証、レート制限、クォータ減算、セキュリティ検証、統計、監査が正常に行われます。