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。

🚀 快速开始

在 Cursor 中使用

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

在 Claude Desktop 中使用

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

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

🛠️ 可用工具 (Tools)

连接成功后，AI 助手将获得以下能力：

• set_current_working_directory: 设置当前工作目录（通常自动处理）。
• get_projects: 搜索您的 Zion 项目列表。支持模糊搜索和分页。
• set_current_project: 设置当前操作的项目上下文。
• get_project_schema: 获取指定项目的详细 Schema 信息，帮助 AI 理解项目结构。
• reauth: 当 Token 过期时触发重新认证。

🔒 安全说明

首次使用时，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 用户辅助开发使用。