FlowLite MCP桥🌉
  
A. 模型上下文协议（MCP）服务器 它将FlowLite工作流自动化作为结构化、可审计的人工智能工具，具有内置的合规性门和不可重复的审计跟踪。
______________________________________________________________________
🤔 为什么会有这种情况？
现代人工智能代理（Claude、GPT5、Llama等）功能强大，但它们需要 安全、结构化的方式 触发现实世界的自动化。如果没有治理，人工智能可以：
- 在没有人批准的情况下执行付款。
- 采取不可逆转的行动，不留痕迹。
- 不应该访问敏感数据。
FlowLite MCP桥解决了这个问题。 它将您的FlowLite工作流程包装在一个久经沙场的协议中，该协议迫使AI在任何操作运行之前通过合规门。
______________________________________________________________________
🎯 用例
虽然我们的例子经常使用发票，但桥梁的设计是为了 任何多步骤自动化 这需要治理：
- 🏗️ 基础设施：“启动PR#42的暂存环境。”（需要成本控制批准）。
- 🔒 安全：“撤消用户的访问权限
john_doe在所有12个SaaS平台上。“（必须进行审计跟踪）。 - 👋 入职：“设置新工程师的电子邮件、Jira和GitHub访问权限。”（多步顺序逻辑）。
- 📊 数据管道：“从这个Slack线程中提取客户反馈并将其写入数据库。”（AI驱动的提取）。
______________________________________________________________________
🚀 快速入门
选项A——直接从npm使用（不需要克隆）：
npx flowlite-mcp-bridge --workflows-dir ./workflows --data-dir ./audit-trails --verbose选项B--克隆并在本地运行：
# 1. Clone and install
git clone https://github.com/kobomarun/flowlite-mcp-bridge.git && cd flowlite-mcp-bridge && npm install
# 2. Build and set up your demo playground (copies example workflows)
npm run build && npm run setup-demo
# 3. Start the bridge
node dist/cli/serve.js --workflows-dir ./playground/workflows --data-dir ./playground/data --verbose跑步时，您将看到：
info: Starting MCP Server: FlowLite MCP Bridge v0.1.0
info: Server connected and listening on stdin/stdout______________________________________________________________________
🤖 连接到AI客户端
克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"flowlite": {
"command": "npx",
"args": [
"-y", "flowlite-mcp-bridge",
"--workflows-dir", "/absolute/path/to/your/workflows",
"--data-dir", "/absolute/path/to/store/audit-logs"
]
}
}
}重新启动克劳德桌面。A. 🔌 FlowLite 工具指示器将出现，您可以说：
*“为Acme Corp运行金额为1250的发票工作流。”*
Cursor IDE
首选 设置→ MCP 并添加：
{
"flowlite": {
"command": "node",
"args": [
"/path/to/flowlite-mcp-bridge/dist/cli/serve.js",
"--workflows-dir", "./workflows",
"--data-dir", "./audit-trails"
]
}
}这也适用于🟢 帆板运动 和🧡 Ollama+开放式WebUI 使用相同的配置格式。
______________________________________________________________________
✍️ 编写您的第一个工作流
创建 ./workflows/hello.yml:
id: hello-world
name: Hello World Workflow
version: 1.0.0
compliance:
requiresHumanApproval: false
steps:
- id: greet
action: flowlite.log
input:
message: "Hello from FlowLite!"然后从任何AI客户端调用它：
{
"method": "tools/call",
"params": {
"name": "flowlite.runWorkflow",
"arguments": { "workflowId": "hello-world", "inputs": {} }
}
}______________________________________________________________________
🏗️ 建筑
graph TD
Client(["AI Client (Claude / GPT / Llama)"]) -->|1. List Tools| Protocol[MCP Protocol Layer]
Protocol -->|2. Serve Manifest| Manifest[Tool Manifest]
Client -->|3. Call flowlite.runWorkflow| Router[Tool Handler Router]
Router -->|4. Validate Schema| Zod((Zod Engine))
Router -->|5. Check Compliance| Adapter[FlowLite Adapter]
Adapter -->|6. Load YAML| FS[(Workflows Folder)]
Adapter -->|7. Execute Workflow| Engine[FlowLite Engine]
Adapter -->|8. Persist Trace| Audit[(Audit Trail Store)]
Adapter -->|9. Result + Metadata| Router
Router -->|10. MCP Response| Client详细信息请参见 docs/ARCHITECTURE.md______________________________________________________________________
🚦 治理与安全
| 功能 | 状态 |
|---|---|
| 核心编排 | ✅ Real FlowLite引擎集成 |
| 人在环（HITL）审批门 | ✅ 被强迫 |
| 每次运行不可重复的审计跟踪 | ✅ 被强迫 |
| 数据分类级别 | ✅ 被强迫 |
| 边界处的严格Zod模式验证 | ✅ 被强迫 |
| 路径遍历保护 | ✅ 被强迫 |
详细信息请参见 docs/GOVERNANCE.md______________________________________________________________________
📚 了解更多
______________________________________________________________________
🗺️ 路线图
看 ROADMAP.md 从第一阶段（基金会）到第四阶段（社区和生态系统）的完整愿景。
______________________________________________________________________
🤝 贡献
我们欢迎捐款！从这里开始：
- 阅读
CONTRIBUTING.md对于技术标准（严格的TypeScript，没有any，模式优先设计）。 - 检查打开 问题 对于任务。
- 使用 PR模板 提交时。
______________________________________________________________________
📜 许可证
麻省理工学院 --免费使用、修改和分发。