中文文档 |中国文献

文档门户： SereinFlow 教程和当前 API 参考（中文）。

SereinFlow 是一个以网页为先的工作流编排与执行系统。它 结合了可视化网页控制台、ASP.NET 核心API、隔离的Worker Runner 流程，以及用于AI工具集成的MCP服务。

项目概述

SereinFlow 用于创建、维护和运行项目工作流程。网络 控制台管理项目、流程、版本、运行和环境设置。该 API负责协调持久化的数据和执行请求，而不受信任的脚本则负责 插件仅在独立的 Worker Runner 进程中运行。MCP 服务 公开受控的工具、资源和提示，方便AI客户端使用 SereinFlow安全。

社区与技术支持

SereinFlow

中文文档 | Chinese documentation

Documentation portal: SereinFlow tutorials and current API reference (Chinese).

SereinFlow is a web-first workflow orchestration and execution system. It combines a visual web console, an ASP.NET Core API, isolated Worker Runner processes, and an MCP service for AI-tool integration.

Project Overview

SereinFlow is used to create, maintain, and run project workflows. The web console manages projects, flows, versions, runs, and environment settings. The API coordinates persisted data and execution requests, while untrusted scripts and plugins run only in separate Worker Runner processes. The MCP service exposes controlled tools, resources, and prompts so AI clients can work with SereinFlow safely.

Community & Technical Support

If you need help using SereinFlow, join the QQ group 955830545 to contact me for technical support, usage discussions, or issue feedback.

Prerequisites

• .NET SDK 10.0.100 or a compatible SDK selected by global.json.
• Node.js 24.19.0, as defined in .node-version, and npm 11.6.2.
• Windows is assumed for the environment-variable and Codex instructions below. The API and frontend commands are otherwise standard .NET and npm commands.

Projects that use SereinLang rely on the pinned source snapshot under src/ThirdParty/SereinScript. A normal SereinFlow build needs neither a separate SereinScript checkout nor a path environment variable.

Run Locally

1. Start the API

From the repository root, run:

dotnet run --project .\src\SereinFlow.Api\SereinFlow.Api.csproj

By default, the API and HTTP MCP service listen on http://127.0.0.1:8188, with MCP available at http://127.0.0.1:8188/mcp. The first start initializes local data under the configured data directory.

2. Start the Web Console

Open a second terminal and run:

Set-Location .\frontend\sereinflow-web
npm ci
npm run dev

Open the URL printed by Vite, usually http://localhost:5173. The development server proxies /api and /hubs to http://127.0.0.1:8188 by default. Set VITE_API_PROXY_TARGET before starting the frontend when the API uses another address.

Configure the MCP Service

The following workflow configures an HTTP MCP client for a locally running SereinFlow instance. Start both the API and the web console before continuing.

1. Generate the Administrator Key

In the web console’s home menu, open Environment settings, find **MCP