Zion MCP Server

Zion MCP Server 是 FunctorZ (Zion) 提供的官方 Model Context Protocol (MCP) 服务端。它允许 Cursor、Claude Desktop 等 AI 助手直接连接到您的 Zion 项目，读取项目结构、数据模型和业务逻辑，从而提供更精准的 AI 辅助开发体验。

✨ 功能特性

• 项目深度集成: 获取 Zion 项目的完整 Schema，包括数据模型 (Data Model)、行为流 (Action Flows)、API 定义等。
• 智能项目管理: 支持模糊搜索项目，快速切换当前上下文。
• 安全认证: 基于 OAuth 的安全认证机制，确保您的数据安全。
• 上下文感知: 自动维护项目上下文，无需在每次请求时重复指定项目 ID。
• Gradle-style Daemon: CLI 和 MCP 共用兼容 daemon，缓存项目 CRDT/ztype 状态；--no-daemon 可执行一次性命令并完全退出。

🚀 快速开始

在 Cursor 中使用

1. 打开 Cursor 设置面板 (Cmd + , 或 Ctrl + ,)。
2. 进入 Features -> MCP。
3. 点击 Add New MCP Server。
4. 填写以下信息：
   • Name: Zion MCP
   • Type: command
   • Command: npx -y zion-mcp@latest
5. 保存并重启 Cursor (如果需要)。

在 Claude Desktop 中使用

在您的 Claude Desktop 配置文件（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）中添加：

{
  "mcpServers": {
    "zion": {
      "command": "npx",
      "args": ["-y", "zion-mcp@latest"]
    }
  }
}

🛠️ 可用工具 (Tools)

连接成功后，AI 助手将获得以下工具。部分为 facade 工具，通过 op 参数选择具体操作：

• Auth: auth（op：LOGIN / LOGOUT / WHOAMI / REAUTH）、get_account_profile。
• Projects: get_projects、create_project、set_current_project、get_current_project、rename_project、rename_project_app、delete_project、reset_project、get_project_schema（保留的简化 Schema 兼容工具）、project_inspect（op：DETAIL / METADATA / RESOURCES）。
• Schema 会话: schema_session（op：LOAD / RELOAD / SYNC / SNAPSHOT / VALIDATE）、schema_observe（op：STATE / EVENTS）、schema_status。修改仅存于内存 CRDT 会话，需 sync_backend 后才会生效上线。
• Actionflow 模板: list_actionflow_node_templates（服务端托管的预置集成节点——短信、视频/AI 生成等——可用于 schema_actionflow_node op=ADD_NODE）。
• Schema 编辑（ztype facades） — 每个工具带一个 op；改动立即生效（用 schema_undo 撤销），再执行 schema_session op=VALIDATE + sync_backend 部署。由 ztype 工具目录自动生成。高频 facade 为常驻 MCP 工具，其余目录项通过 search_tools / describe_tool 按需发现（见下方 工具发现），再经 ztype_tool_calls 执行：

• schema_actionflow — op: ADD / ADD_GLOBAL_VARS / ADD_INPUT_PARAMS / ADD_OUTPUT_FIELDS / ADD_CUSTOM_CODE_NODE_OUTPUT_VALUE / CLEAR_OUTPUT / CLEAR_CUSTOM_CODE_NODE_OUTPUT_TYPE / DELETE / DELETE_GLOBAL_VARS / DELETE_INPUT_PARAMS / DELETE_OUTPUT_FIELDS / DELETE_CUSTOM_CODE_NODE_OUTPUT_VALUE / GET_DETAIL / GET_ACTION_FLOW_NODE_DETAIL / SELECTABLE_TYPES / LIST / SET_OUTPUT / SET_CUSTOM_CODE_NODE_OUTPUT_TYPE / UPDATE / UPDATE_GLOBAL_VARS / UPDATE_INPUT_PARAMS / UPDATE_CUSTOM_CODE_NODE_OUTPUT_VALUE
• schema_actionflow_node — op: ADD_BRANCH_ITEM / ADD_NODE / ADD_CODE_INPUT / ADD_VAR_TARGETS / DELETE_NODES / DELETE_CODE_INPUT / DELETE_VAR_TARGETS / CONTEXT_INFO / MOVE_NODE / RENAME_CODE_INPUT / UPDATE_NODE
• schema_add_tpa_config_parameters — op: ADD_TPA_CONFIG_PARAMETERS
• schema_add_tpa_configs — op: ADD_TPA_CONFIGS
• schema_add_tpa_parameter_children — op: ADD_TPA_PARAMETER_CHILDREN
• schema_add_tpa_response_data — op: ADD_TPA_RESPONSE_DATA
• schema_add_tpa_response_data_children — op: ADD_TPA_RESPONSE_DATA_CHILDREN
• schema_api — op: ADD / ADD_INPUT_VARIABLES / ADD_PARAMETERS / ADD_RESPONSE_CONFIGS / ADD_WORKSPACES / ADD_WORKSPACE_CONSTANTS / DELETE / DELETE_INPUT_VARIABLES / DELETE_PARAMETERS / DELETE_RESPONSE_CONFIGS / DELETE_WORKSPACES / DELETE_WORKSPACE_CONSTANTS / LIST / LIST_WORKSPACES / GET_DETAIL / UPDATE / UPDATE_INPUT_VARIABLES / UPDATE_PARAMETERS / UPDATE_RESPONSE_CONFIGS / UPDATE_WORKSPACE / UPDATE_WORKSPACE_CONSTANTS
• schema_binding_inspect — op: BINDING_OPTIONS / BINDING_TYPE / FORMULA_CONFIG_OPTIONS / FORMULA_OPERATORS
• schema_common — op: SET_DISPLAY_NAME
• schema_component — op: LIST_PAGES / GET_CONTEXT_INFO / GET_INFO / GET_CHILDREN_INFO
• schema_condition_expr — op: DELETE_TERM / LIST_OPERATORS / INSERT_TERM / NEST / TOGGLE_AND_OR / TOGGLE_NOT / SET_OPERATOR
• schema_conditional_branch — op: DELETE / INSERT / REORDER / UPDATE
• schema_create_binding — op: CONDITIONAL / CONST / FORMULA / OPTION / SET_FORMULA_CONFIG
• schema_delete_tpa_config_parameters — op: DELETE_TPA_CONFIG_PARAMETERS
• schema_delete_tpa_configs — op: DELETE_TPA_CONFIGS
• schema_delete_tpa_parameter_children — op: DELETE_TPA_PARAMETER_CHILDREN
• schema_delete_tpa_response_data — op: DELETE_TPA_RESPONSE_DATA
• schema_delete_tpa_response_data_children — op: DELETE_TPA_RESPONSE_DATA_CHILDREN
• schema_get_all_tpa_config_infos — op: GET_ALL_TPA_CONFIG_INFOS
• schema_get_tpa_config_detail — op: GET_TPA_CONFIG_DETAIL
• schema_overview — op: GET_ENTITY_RELATION_GRAPH / GET_PROJECT_OVERVIEW
• schema_permission — op: ACTIVATE_ROLE_PERMISSION / ADD_ROLES / DELETE_ROLES / GET_ALL_ROLE_INFOS / GET_ROLE_DETAIL / SET_ROLE_PERMISSION_CHECK / UPDATE_ROLE / UPDATE_ROLE_ACTION_FLOW_PERMISSION / UPDATE_ROLE_API_PERMISSION / UPDATE_ROLE_PAYMENT_PERMISSION / UPDATE_ROLE_TABLE_PERMISSION / UPDATE_ROLE_TPA_PERMISSION / UPDATE_ROLE_ZAI_PERMISSION
• schema_request_filter — op: ADD_FILTER / ADD_CONDITION / ADD_SORT / DELETE_FILTER / DELETE_CONDITION / DELETE_SORT / CONTEXT / NEST_CONDITION / REORDER_FILTERS / REORDER_SORT / SET_UPDATE_COLUMN_ARITHMETIC / TOGGLE_CONDITION_AND_OR / TOGGLE_CONDITION_NOT / UPDATE_FILTER / SET_CONDITION_OPERATOR / UPDATE_SORT
• schema_secret — op: ADD_SECRET_CONFIGS / DELETE_SECRET_CONFIGS / GET_ALL_SECRET_CONFIGS / UPDATE_SECRET_CONFIG
• schema_set_tpa_config_paging — op: SET_TPA_CONFIG_PAGING
• schema_table — op: ADD_CONSTRAINTS / ADD_FIELDS_RELATIONS / ADD_TABLES / ADD_EXTENSION / DELETE_CONSTRAINTS / DELETE_FIELDS_RELATIONS / DELETE_TABLES / DELETE_EXTENSION / LIST_NAMES / LIST_EMBEDDING_MODELS / GET_INFOS
• schema_trigger — op: ADD_DB_TRIGGERS / ADD_SCHEDULED_TRIGGERS / DELETE_DB_TRIGGERS / DELETE_SCHEDULED_TRIGGERS / GET_ALL_DB_TRIGGER_INFOS / GET_ALL_SCHEDULED_TRIGGER_INFOS / GET_DB_TRIGGER_DETAIL / GET_SCHEDULED_TRIGGER_DETAIL / UPDATE_DB_TRIGGER / UPDATE_SCHEDULED_TRIGGER
• schema_type — op: ADD_ENUMS / ADD_OBJECTS / ADD_FIELDS / DELETE_ENUMS / DELETE_OBJECTS / DELETE_FIELDS / LIST_ENUMS / LIST_OBJECTS / UPDATE_ENUMS / UPDATE_OBJECTS
• schema_update_tpa_config — op: UPDATE_TPA_CONFIG
• schema_update_tpa_config_parameter — op: UPDATE_TPA_CONFIG_PARAMETER
• schema_update_tpa_parameter_child — op: UPDATE_TPA_PARAMETER_CHILD
• schema_update_tpa_response_data — op: UPDATE_TPA_RESPONSE_DATA
• schema_update_tpa_response_data_child — op: UPDATE_TPA_RESPONSE_DATA_CHILD
• schema_zai_config — op: ADD_ZAI_CONFIGS / ADD_ZAI_CONFIG_API_CONTEXTS / ADD_ZAI_CONFIG_DB_CONTEXTS / ADD_ZAI_CONFIG_INPUT_ARGS / ADD_ZAI_CONFIG_OUTPUT_FIELDS / ADD_ZAI_CONFIG_TOOLS / ADD_ZAI_CONFIG_TPA_CONTEXTS / DELETE_ZAI_CONFIGS / DELETE_ZAI_CONFIG_API_CONTEXTS / DELETE_ZAI_CONFIG_DB_CONTEXTS / DELETE_ZAI_CONFIG_INPUT_ARGS / DELETE_ZAI_CONFIG_OUTPUT_FIELDS / DELETE_ZAI_CONFIG_TOOLS / DELETE_ZAI_CONFIG_TPA_CONTEXTS / GET_ALL_ZAI_CONFIG_INFOS / GET_ZAI_CONFIG_DETAIL / GET_ZAI_CONFIG_SELECTABLE_TYPES / GET_ZAI_MODEL_OPTIONS / UPDATE_ZAI_CONFIG / UPDATE_ZAI_CONFIG_API_CONTEXT / UPDATE_ZAI_CONFIG_DB_CONTEXT / UPDATE_ZAI_CONFIG_INPUT_ARGS / UPDATE_ZAI_CONFIG_OUTPUT / UPDATE_ZAI_CONFIG_OUTPUT_FIELD / UPDATE_ZAI_CONFIG_OUTPUT_MODE / UPDATE_ZAI_CONFIG_TOOL / UPDATE_ZAI_CONFIG_TOOL_DESCRIPTION_CONFIGS / UPDATE_ZAI_CONFIG_TOOL_FIELD_DESCRIPTIONS / UPDATE_ZAI_CONFIG_TPA_CONTEXT

• Schema 编辑 — 底层: ztype_tool_calls。
• 工具发现: search_tools、describe_tool。仅高频 ztype facade 注册为常驻工具；用 search_tools 查找被延迟加载的目录项，用 describe_tool 读取其 op 列表与参数 schema，再经 ztype_tool_calls 执行。
• 部署: sync_backend。
• 数据 (Runtime): runtime_graphql（原始 GraphQL：查询、变更、聚合、关联、调用 actionflow/AI agent、预签名素材上传）。
• 日志与文档: search_logs、search_docs、get_doc_page。
• 平台后端: platform_graphql。
• 工作区: set_current_working_directory（设置当前工作目录，通常自动处理）。
• Escape hatch: agent_command（直接调用任意内部命令）。

CLI / Daemon

以下命令均可用。多词动词与其别名一并列出；--args '<json>' 接受与对应 MCP 工具相同的参数。

# 服务 / daemon
zion-mcp mcp
zion-mcp version-check
zion-mcp daemon start
zion-mcp daemon foreground
zion-mcp daemon status
zion-mcp daemon stop

# 认证
zion-mcp login
zion-mcp logout
zion-mcp whoami
zion-mcp reauth
zion-mcp account profile            # 别名: account me

# 项目
zion-mcp projects search
zion-mcp projects list
zion-mcp project create
zion-mcp project set-current
zion-mcp project current            # 别名: project get-current
zion-mcp project detail
zion-mcp project metadata           # 别名: project inspect
zion-mcp project resources
zion-mcp project rename
zion-mcp project rename-app
zion-mcp project delete
zion-mcp project reset
zion-mcp project sync-backend       # 别名: project deploy-backend

# Actionflow
zion-mcp actionflow list-node-templates

# Schema
zion-mcp schema load
zion-mcp schema reload
zion-mcp schema status
zion-mcp schema state
zion-mcp schema events
zion-mcp schema sync
zion-mcp schema snapshot
zion-mcp schema validate            # 别名: schema type-check
zion-mcp schema tool-call           # 别名: schema tool-calls
zion-mcp schema undo
zion-mcp schema redo

# Runtime 数据
zion-mcp runtime graphql
zion-mcp runtime query
zion-mcp runtime insert
zion-mcp runtime update
zion-mcp runtime delete

# 日志与文档
zion-mcp logs search
zion-mcp docs search
zion-mcp docs get-page

# ZB passthrough
zion-mcp platform graphql

# 全局 flags（可与任意命令组合）
zion-mcp --no-daemon whoami
zion-mcp --cwd <dir> schema status
zion-mcp schema status --pretty
zion-mcp schema load --args '{"projectExId":"..."}'

为 schema load 选择项目

schema load 不直接接受 --projectExId。请通过通用 JSON 参数传入项目：

zion-mcp schema load --args '{"projectExId":"<exId>"}' --pretty

或者先固定当前项目，再无参数加载：

zion-mcp project set-current --projectExId <exId>
zion-mcp schema load --pretty

如只需单次检查路由、不启动可复用 daemon，请把全局 flag 放在命令前： zion-mcp --no-daemon schema load --args '{"projectExId":"<exId>"}' --pretty。

默认 CLI 命令会复用兼容 daemon；兼容性包含产品、Node 版本和平台、后端地址、认证用户、ztype/schema 版本、CRDT/json-joy 版本、工作区根目录和启动 flags。Daemon 空闲 3 小时退出；项目 Schema 会在空闲 5 分钟后卸载。

🔒 安全说明

首次使用时，MCP Server 会启动浏览器进行 OAuth 认证。认证 Token 会安全地存储在您的本地系统中。

🏗️ 什么是 Zion?

Zion 是新一代的全栈无代码平台，拥有专为 Headless 使用场景设计的强大后端。Zion 不仅提供可视化的全栈应用构建能力，其后端也可作为独立的 Backend-as-a-Service (BaaS) 使用，完美适配自定义前端开发。

为什么选择 Zion 作为 BaaS?

✅ 企业级 PostgreSQL - 强大且符合 ACID 标准的关系型数据库
✅ 自动生成 GraphQL API - 数据模型自动转化为类型安全的 GraphQL Schema
✅ 内置后端逻辑 - 通过行为流 (Actionflows) 可视化编排复杂业务逻辑，无需编写代码
✅ 原生 AI 集成 - 内置 AI Agent 支持，包含 RAG、工具调用及结构化输出能力
✅ 第三方 API 转发 - 支持导入 OpenAPI 规范，作为带认证的后端中继使用
✅ 微信/支付宝支付集成 - 原生支持主流支付渠道，轻松处理订阅与一次性支付
✅ 文件存储 - 图片及二进制文件管理，自带 CDN 加速
✅ 身份认证 - 内置基于 JWT 的用户管理体系
✅ 实时订阅 - 通过 GraphQL Subscriptions 支持 WebSocket 实时推送
✅ 可预测的定价 - 基于项目的定价模式，无单次请求计费烦恼

🔗 相关链接

• Zion 官网
• Model Context Protocol

📖 更多资源

Zion 文档

• Zion 官方文档
• 快速开始
• 数据库配置
• 行为流 (Actionflow) 指南
• AI Agent 教程
• 支付集成

注意：本工具仅供 Zion 用户辅助开发使用。