Appwrite:用 MCP 连接智能体的一体化开源云
给开发者和智能体用的一体化开源云,MCP 能直接操作项目,不只提供传统 SDK。
GitHub appwrite/appwrite 更新 2026-11-19 分支 main 星标 58.2K 分叉 5.9K
TypeScript PHP MCP Docker 自托管云平台

🧭 决策指南

适合,如果你

  • 你要让 Cursor、Claude Code 或 Codex 操作真实 Appwrite 项目
    README 的 Getting Started 和正文写明可通过 hosted MCP server 连接这些 agents;MCP included on Cloud。
  • 你希望一个平台同时提供 Auth、Databases、Storage、Functions 和 Realtime
    README 的 Products 章节列出 Auth、Databases、Storage、Functions、Messaging、Firewall 和 Realtime。
  • 你需要在 Docker CLI 可运行的基础设施上自托管
    README 的 Self-Hosting 章节说明 Appwrite 可安装在任何能运行 Docker CLI 的操作系统上。
  • 你的数据库方案需要在 Appwrite、PostgreSQL 和 MySQL 之间选择
    README 的 Databases 产品说明同时支持 Appwrite databases、managed PostgreSQL 和 MySQL。

不适合,如果你

  • 运行环境不能安装 Docker CLI,或无法处理 localhost:20080 的安装流程
    README 的 Self-Hosting 章节将 Docker CLI 列为前置条件,安装器监听 127.0.0.1:20080。
  • 你需要把远程安装器端口 20080 直接公开到所有网络接口
    README 明确要求远程主机通过 SSH 隧道访问 127.0.0.1:20080,而不是把端口发布到所有接口。
  • 你要升级旧版 Appwrite,但不准备使用 migration tool
    README 的 Upgrade from an Older Version 章节要求安装完成后使用 Appwrite migration tool。

前置条件

  • 自托管前必须安装 Docker;README 原文为“Before running the installation command, make sure you have Docker installed on your machine.”
  • 安装器使用 localhost 的 20080 端口,并打印一次性 installer secret 到 STDOUT。
  • 远程主机需要 SSH 隧道连接 127.0.0.1:20080。
  • 如果出现 Docker API 1.52 与最大支持版本 1.42 的错误,需要设置 DOCKER_API_VERSION=1.42 或升级主机 Docker。
  • 项目最新版本为 2.7.3;README 安装命令使用 appwrite/appwrite:2.7.2。

第一步命令(README 原文)

docker run -it --rm \
    --publish 127.0.0.1:20080:20080 \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="install" \
    appwrite/appwrite:2.7.2

要注意

  • 安装器只发布到 127.0.0.1:20080,远程主机应使用 SSH 隧道。
    README 的 Self-Hosting 章节明确说明 setup wizard listens on port 20080 and is published on localhost only。
  • Docker API 版本不匹配时,安装和升级都可能失败。
    README 的 Docker API version mismatch 章节给出 client version 1.52 与 maximum supported API version 1.42 的错误。
  • 旧版升级不能只运行 setup,还要执行 Appwrite migration tool。
    README 的 Upgrade from an Older Version 章节要求 setup 完成后使用 migration tool。

材料未说明

  • README 未说明 Auth、Databases 或 Functions 的具体资源上限、性能指标和计费边界。
  • README 未说明 Appwrite Cloud Free plan 的具体配额、超额价格和服务等级。
  • README 未提供 MCP 支持的完整工具列表、权限模型和审计细节。
  • README 未说明 Docker、操作系统、CPU、内存和存储的最低版本或容量要求。
  • README 的技术生态数据未给出 TypeScript、PHP、C、Rust 与 CSS 各模块的具体职责分布。

💡 深度解析

6
适合 我使用 Cursor、Claude Code 和 Codex,希望代理不仅生成代码,还能连接真实项目、API 和文档并操作 Appwrite 资源;MCP 是否适合这个工作流?
适合读者: 使用 Cursor、Claude Code 或 Codex,希望让 AI 编程代理直接操作真实 Appwrite 项目资源的开发者

适合,因为 Appwrite 将 MCP 作为平台能力提供,目标正是让代理操作 live Appwrite project,而不只是生成脱离环境的代码。

  • README 明确写出 “MCP is included, so coding agents can operate on a live Appwrite project”。
  • 文档列出 Cursor、Claude Code、Codex 等代理,并说明可通过 hosted MCP server 连接项目、API 和文档。
  • MCP 在 Cloud 中无需本地安装,降低了接入门槛;同时平台还提供 SDK、CLI 和 Terraform 等非代理入口。
  • 代理可触达 Auth、Databases、Storage、Functions、Messaging、Realtime 和 Hosting 等项目能力,因此权限边界比普通代码补全更重要。

适合并不等于可以无约束地授予生产权限。README 未定义每种代理操作的权限粒度、审批机制、审计字段或删除操作保护,需要另行确认。

  • README 首页:`MCP is included, so coding agents can operate on a live Appwrite project.`
  • README 首页:`Connect Cursor, Claude Code, Codex, and other agents through the hosted MCP server`
  • README「Products」:Appwrite MCP 可连接 projects、APIs、docs;Cloud 中无需 local install
  • README「Products」:Auth、Databases、Storage、Functions、Messaging、Realtime、Hosting
材料未说明:README 未说明 MCP 工具的逐操作授权模型、审计日志格式和高风险操作确认机制;README 未说明 hosted MCP server 的数据区域、配额和企业级隔离选项
适合 我正在用 Flutter 和 React Native 开发移动应用,需要邮箱、短信、OAuth、匿名会话、文件存储和推送通知;Appwrite 能否替代我分别集成多套后端服务?
适合读者: 使用 Flutter、React Native、iOS 或 Android 客户端、希望减少认证和后端服务拼装的小型应用团队

适合,因为 README 直接覆盖了移动应用所需的认证、文件、通知和多种客户端接入能力。

  • Auth 支持 email、SMS、OAuth、anonymous sessions 和 magic URLs,可减少移动端分别接入身份供应商的工作。
  • Storage 提供 compression、encryption、image transformations 和 access control,适合头像、附件和媒体文件。
  • Messaging 统一发送 email、SMS 和 push notifications;Realtime 允许客户端订阅项目资源变化。
  • README 的架构入口包含 Flutter、iOS、Android、Web、SDKs 和 REST、WebSocket、GraphQL、S3 等接口,说明它不是只面向单一前端框架。

但它不能自动证明所有移动端配额、推送供应商限制或离线同步行为都满足需求;这些信息需要查看 Cloud 计划和对应 SDK 文档。

  • README「Products」:Auth 支持 email、SMS、OAuth、anonymous sessions、magic URLs
  • README「Products」:Storage 支持 compression、encryption、image transformations、access control
  • README「Products」:Messaging 发送 email、SMS、push notifications;Realtime 支持订阅事件
  • README「Architecture」:入口包含 Flutter、iOS、Android、Web、SDKs;支持 REST、WebSocket、GraphQL、S3
  • 项目数据:topics 包含 flutter、ios、android、react-native、swift
材料未说明:README 未列出各移动平台 SDK 的版本兼容矩阵;README 未说明推送服务供应商、离线同步和 Cloud 计划的具体配额
视情况 我的宿主机 Docker Engine 只支持 API 1.42,而且我需要从旧版 Appwrite 升级到当前版本;README 给出的安装和升级路径能否直接使用?
适合读者: 维护旧版 Docker Engine、准备从旧 Appwrite 版本升级并使用自定义 Docker Compose 的部署者

视情况,可以按 README 的兼容性路径处理,但不能只替换镜像;宿主机 API 版本和迁移步骤都会影响结果。

  • README 明确描述了 client version 1.52 is too new. Maximum supported API version is 1.42 的失败场景,并要求设置 DOCKER_API_VERSION=1.42 或升级宿主机 Docker。
  • 安装命令使用 appwrite/appwrite:2.7.2,而项目数据记录的 latest release 是 2.7.3,存在示例版本与当前发布版本不一致。
  • README 说明升级时要把相同的 --env DOCKER_API_VERSION=... 用于 --entrypoint="upgrade",并建议高级部署查看环境变量、docker-compose.yml 和 .env。
  • 自定义 Compose 适合需要自行配置环境的部署,但 README 片段没有给出完整升级命令或迁移失败恢复流程。
  • README「Docker API version mismatch」:`client version 1.52 is too new. Maximum supported API version is 1.42`
  • README「Docker API version mismatch」:`DOCKER_API_VERSION=1.42` 与 `--entrypoint="upgrade"`
  • README「Docker API version mismatch」:可使用 public `docker-compose.yml` 和 `.env` 文件
  • 项目数据:latest_release 为 `2.7.3`;README 示例镜像为 `appwrite/appwrite:2.7.2`
docker run -it --rm \
    --env DOCKER_API_VERSION=1.42 \
    --publish 127.0.0.1:20080:20080 \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
    --entrypoint="install" \
    appwrite/appwrite:2.7.2
材料未说明:README 未提供从 2.7.2 或更早版本升级到 2.7.3 的具体迁移步骤;README 未说明 Docker API 1.42 下所有 Appwrite 组件是否都经过当前版本验证
适合 我使用 Next.js,需要从 Git 部署 SSR 或 CSR 前端、生成预览,并让后端函数响应事件、页面订阅实时变化;Appwrite 能否把这些能力放在同一平台?
适合读者: 负责 Next.js SSR、CSR 或静态前端部署,同时需要 Git 预览、Serverless Functions 和实时数据的 Web 开发者

适合,Appwrite 的 Sites、Functions 和 Realtime 正好对应 Next.js 前端托管、事件驱动后端逻辑与实时订阅需求。

  • Sites 支持从 Git 部署 static、SSR 和 CSR frontends,并提供 instant previews,覆盖 Next.js 常见的部署形态。
  • Functions 支持 secure isolated runtimes 和 event-driven execution,适合将业务触发逻辑放在后端,而不是把密钥暴露给浏览器。
  • Realtime 支持订阅项目资源变化;架构图还显示 Queue、Workers、Executor 和 Open Runtimes,用于承载后台任务和函数执行。
  • REST、WebSocket 和 GraphQL 等 API 可与现有客户端或服务端协议衔接,降低只依赖单一 SDK 的限制。

但 README 没有说明 Next.js 具体版本、SSR 运行时限制、函数执行时长或预览环境的隔离方式,因此复杂 SSR 应用仍需核对部署文档。

  • README「Products」:Sites 支持从 Git 部署 static、SSR、CSR frontends 和 instant previews
  • README「Products」:Functions 支持 secure isolated runtimes 和 event-driven execution
  • README「Products」:Realtime 支持订阅项目资源变化
  • README「Architecture」:Queue、Workers、Executor、Open Runtimes;支持 REST、WebSocket、GraphQL
  • 项目数据:topics 包含 nextjs、react、web
材料未说明:README 未说明支持的 Next.js 版本和 SSR 运行时限制;README 未说明 Functions 的执行时长、并发、冷启动和外部网络限制;README 未说明 Sites 预览环境是否与生产资源完全隔离
视情况 我想把使用 React 或 Next.js 的应用从原型推进到生产,并部署在 AWS、DigitalOcean 或 Azure,而不是把数据放在托管 BaaS 中;Appwrite 的自托管模式适合我吗?
适合读者: 需要在自有基础设施、AWS、DigitalOcean 或 Azure 上部署后端,并希望保留数据与运维控制权的独立开发者

视情况,适合重视数据控制且愿意承担 Docker 运维责任的开发者,不适合希望平台替自己完成备份、升级和安全响应的人。

  • README 明确支持 managed cloud 和 self-hosting,并提供 AWS、DigitalOcean、Google Cloud、Azure 等部署指南。
  • 平台把 Auth、Databases、Storage、Functions、Messaging、Realtime、Sites 和 Firewall 统一在一个项目模型中,能覆盖 React/Next.js 应用从原型到生产的常见后端需求。
  • 架构使用混合单体-微服务、缓存、消息队列和后台 Worker,具备扩展路径,但部署者仍需管理 Docker、网络、域名、存储和升级迁移。
  • README 的安装示例还会挂载 Docker socket,并监听 127.0.0.1:20080;这意味着生产暴露方式和隔离策略必须由部署者决定。
  • README「Self-Hosting」与「One-Click Setups」:提供 managed cloud、自托管以及 AWS、DigitalOcean、Google Cloud、Azure 指南
  • README「Products」:Auth、Databases、Storage、Functions、Sites、Messaging、Firewall、Realtime
  • README「Architecture」:hybrid monolithic-microservice architecture;background workers;message queue
  • README「Docker API version mismatch」:`--publish 127.0.0.1:20080:20080` 与 `--volume /var/run/docker.sock:/var/run/docker.sock`
材料未说明:README 未给出不同云平台的最低 CPU、内存、磁盘和高可用配置;README 未说明 Cloud 与自托管在具体配额、功能和支持责任上的完整差异
视情况 我已有 PostgreSQL 或 MySQL 经验,希望保留现有查询和数据技术栈,同时通过 REST、GraphQL、WebSocket 或 S3 接入认证、存储和函数;Appwrite 是否能降低迁移约束?
适合读者: 需要在 Appwrite 数据库、托管 PostgreSQL 或 MySQL 之间做选择,并希望通过标准 API 接入现有系统的后端开发者

视情况,Appwrite 能提供多种数据库方向和标准接口,但不能据此假设 Appwrite 数据库、PostgreSQL 与 MySQL 的行为完全等价。

  • Databases README 明确支持 Appwrite databases 或 managed PostgreSQL and MySQL,给已有数据库经验的团队保留了选型空间。
  • Architecture 章节列出 REST、GraphQL、WebSocket 和 S3,适合分别连接服务端、实时客户端和对象存储工具链。
  • 统一平台还包含 Auth、Storage、Functions 和 Messaging,可减少把数据库、身份、文件和计算拆给多个供应商的工作。
  • 但项目洞察指出,数据库兼容性不代表查询、索引、权限、事务和数据模型完全一致;复杂 SQL、专用数据库特性或迁移回滚方案仍需单独验证。

因此它适合希望逐步整合后端能力的团队,不适合把“支持 PostgreSQL/MySQL”理解为现有应用可以无修改迁移。

  • README「Products」:Databases 支持 Appwrite databases 或 managed PostgreSQL and MySQL
  • README「Architecture」:支持 REST、WebSocket、GraphQL、S3
  • README「Products」:Auth、Databases、Storage、Functions、Messaging 统一提供
  • 项目洞察「usage_limitations」:数据库兼容性不意味着查询、索引、权限、事务和数据模型完全等价
材料未说明:README 未列出 Appwrite Databases 与 PostgreSQL/MySQL 之间的具体迁移工具和兼容性矩阵;README 未说明各数据库选项对事务、索引、全文搜索和扩展的支持范围

✨ 核心亮点

  • MCP 内置,Cursor 和 Claude Code 可操作项目
  • Auth、Databases、Storage 等产品统一提供
  • 支持 Cloud 与 Docker CLI 自托管
  • 58,227 星、5,888 Fork,社区规模较大

🔧 工程化

  • MCP 连接 Cursor、Claude Code 与实时 Appwrite 项目
  • Auth 覆盖 OAuth、短信、匿名会话和魔法链接
  • Functions 提供隔离运行时与事件驱动执行
  • Sites 从 Git 部署静态、SSR 和 CSR 前端
  • Databases 支持 Appwrite、PostgreSQL 和 MySQL

⚠️ 风险

  • 自托管必须安装 Docker,安装器监听 localhost:20080
  • 远程主机需 SSH 隧道,README 不建议直接开放 20080
  • Docker API 1.52 与主机 1.42 可能产生版本错误
  • 旧版升级完成后还必须使用 Appwrite migration tool

👥 适合谁?

  • 需要 Auth、Storage、Functions 一体化的 Web 团队
  • 使用 Cursor、Claude Code 或 Codex 的智能体开发者
  • 需要 Docker CLI 自托管并控制基础设施的团队