Low-Code Agent Kit — AI 低代码开发工具

EAP + OpenBPM · EXTN · CloudFile — 一套面向 AI Coding 的 Skills/MCP 工具契约，多套平台适配器。

架构 · 安全边界 · 演进计划

当前交付范围：v0.1.0

首版是可运行的只读 MCP stdio 原型，不是生产级配置修改器。

已有的 CloudFile Toolkit 负责文件、导入、诊断等深度技能，不在此重新造一套文件客户端或 CLI。

Related MCP server: Express REST API and MCP Server Framework

快速开始

依赖 Python 3.11+ 与 uv。

git clone https://github.com/eaopen/lowcode-agent-kit.git
cd lowcode-agent-kit
uv sync

# 只读发现和离线规划不需要配置账号
LOWCODE_PLATFORM=eap-obpm uv run lowcode-mcp

联网查元数据时，仅通过运行进程环境传入目标实例和当前用户凭证：

export LOWCODE_PLATFORM=eap-obpm   # 或 extn / cloudfile
export LOWCODE_API_BASE_URL=https://example.internal/obpm-api
export LOWCODE_TOKEN='<from-local-credential-manager>'
uv run lowcode-mcp

CloudFile 默认采用 Authorization: Token ...，其他两套默认采用 Bearer；如系统实际认证不同，可用 LOWCODE_AUTH_HEADER / LOWCODE_AUTH_SCHEME 配置。远程 HTTP 明文连接默认禁止，受控内网实验环境需明确开启 LOWCODE_ALLOW_INSECURE_HTTP=true。

在 Codex、Claude Code、Paseo 或其他支持 MCP 的工具中注册上述 stdio 命令。多个平台使用多个独立 MCP 连接，分别配置凭据与目标环境，避免跨租户/项目混用身份。

MCP 工具

• platform_discover()：读取本地适配器声明的能力，不访问服务器。

• platform_inspect(capability, identifier)：通过白名单中列出的既有 REST API 读取资源。

• preview_change(before_json, after_json)：本地比较两份 JSON，生成摘要与哈希，不应用。

示例：先 discover，再 inspect 一个有授权的表单，然后预览拟议修改。当前没有任何配置写入、业务审批、任意 REST、SQL 或文件下载工具。

注意：离线发现不能证明目标部署版本支持该接口。 具体 URL、权限、数据模型须在目标实例验证。本仓库当前的测试不包含真实业务登录及审批。

通用 Skills 安装

通用安装器可以把本仓库的 Skills 按需链接/复制到用户指定的 Agent Skills 目录，不内置任何项目专属逻辑，也不会覆盖已有同名技能。

# 请将 --target 换成当前 AI Agent 实际扫描的 Skills 目录
uv run lowcode-install-skills --skill eap-obpm --target /path/to/agent/skills --dry-run
uv run lowcode-install-skills --skill eap-obpm --target /path/to/agent/skills

# Windows 没有创建符号链接权限时，使用复制（更新时需显式管理旧副本）
uv run lowcode-install-skills --skill eap-obpm --target /path/to/agent/skills --method copy

不指定 --skill 时安装三套平台 Skill。link 模式跟随当前 Git checkout；在依赖仓库固定版本时可用 Git submodule 按已审查的 SHA 锁定更新。copy 模式不会自动覆盖旧版本，避免误覆盖开发者自定义文件。

Skills 与项目扩展

• EAP + OpenBPM

• EXTN

• CloudFile

Skills 是开发流程指导；实际数据查询由 MCP 适配器执行。项目专有配置应始终留在其独立权限域内，不把业务数据、身份凭据或内部资料复制到公共仓库。

开发与测试

uv run python -m unittest discover -s tests -v

适配器仅使用已核对的固定 REST 端点；服务端权限最终生效。首版不提供公网 MCP HTTP 服务，也没有支持生产写入的授权协议。

许可证

Apache-2.0。CloudFile 的 Seafile 源码及其他上游项目仍遵循原有许可证；本仓库不复制它们的服务端实现。