# McpFlow

**Repository Path**: bitfaner/mcp-flow

## Basic Information

- **Project Name**: McpFlow
- **Description**: 让 MCP 飞一会儿
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-19
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP Flow

一个工作流编排示例，包含 React 前端和 Go 后端。

## 功能

- 创建工作流、保存、试运行、发布、启动、停止。
- 我的工作流支持草稿、模板、运行中三个列表。
- 点击工作流进入画布并重现节点、关系和状态。
- 节点异常或缺少授权会生成站内通知。
- 通知中心可跳转到对应节点，处理后后端自动把工作流恢复为运行中。

## 启动

后端：

```bash
GOCACHE=/tmp/mcp-flow-go-build-cache go run ./backend/cmd/server
```

默认会使用本地 SQLite 文件 `data/mcp-flow.sqlite` 持久化工作流和通知状态。可以用 `DB_PATH` 指定数据库位置：

```bash
DB_PATH=/tmp/mcp-flow.sqlite GOCACHE=/tmp/mcp-flow-go-build-cache go run ./backend/cmd/server
```

前端：

```bash
cd frontend
npm install
npm run dev
```

默认前端请求 `http://localhost:8080`。如需修改：

```bash
VITE_API_BASE=http://localhost:8080 npm run dev
```

## 验证

```bash
GOCACHE=/tmp/mcp-flow-go-build-cache go test ./...
cd frontend && npm run build
```

## FlowGram

前端已安装 `@flowgram.ai/free-layout-editor`，并在 `frontend/src/lib/flowgram.ts` 中把后端工作流模型转换为 FlowGram `WorkflowJSON`。当前画布使用本地 React/SVG 渲染层承载业务闭环；后续接入完整 FlowGram 节点 registry 时，可复用该 adapter 替换 `WorkflowCanvas` 的渲染实现。