mcpField
A
Appwrite MCP server

Appwrite MCP server

远程服务
appwrite.io云与基础设施72今天更新

关于 Appwrite MCP server

Appwrite MCP server 是 Appwrite 官方提供的 MCP 服务,将数据库、用户、函数、团队和存储等 Appwrite API 以工具形式开放给 MCP 客户端。用户可连接托管服务器并通过浏览器完成授权,无需手动管理密钥。

主要功能

  1. 01托管服务器与浏览器授权登录
  2. 02数据库、用户、函数、团队与存储等 API 工具
  3. 03支持主流 MCP 客户端的配置方式
  4. 04文档搜索工具 appwrite_search_docs
  5. 05支持可自托管的 Appwrite 实例(本地 stdio)

适用场景

  1. 01通过 AI 助手管理 Appwrite 后端项目
  2. 02在 IDE 或命令行客户端中查询 Appwrite 数据与配置
  3. 03在自托管的 Appwrite 实例上以本地方式运行服务

MCP 相关

该项目是一个 MCP 服务,向 MCP 客户端暴露 Appwrite API 的各类工具,并支持通过 OAuth 2.1 进行身份验证。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.appwrite.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Appwrite MCP 服务

MCP Registry Version

一个用于 Appwrite 的 Model Context Protocol 服务。 它将 Appwrite 的 API——数据库、用户、函数、团队、存储等—— 作为 MCP 客户端可调用的工具提供。

连接托管服务 https://mcp.appwrite.io/,并通过浏览器完成身份验证。 首次连接时,客户端会打开 Appwrite 授权页面;批准所需权限范围后即可连接。无需 复制任何密钥。常用的 https://mcp.appwrite.io/mcp URL 也受支持,并会 连接到同一服务。

Appwrite MCP 服务如何处理 OAuth 和权限范围

连接客户端

选择下方的客户端。每种方式都会添加托管的 Appwrite Cloud 服务。

Claude Code
claude mcp add --transport http appwrite https://mcp.appwrite.io/

然后,在 Claude Code 会话中运行 /mcp,选择 appwrite,并按照 浏览器提示完成身份验证。

Claude Desktop

前往 Settings → Connectors → Add custom connector,粘贴 https://mcp.appwrite.io/。Pro 和 Max 方案可用;在 Team 和 Enterprise 方案中,只有组织 Owner 可以添加自定义连接器。

如果看不到该选项(免费方案,或 Team/Enterprise 成员),请改用 stdio 桥接 远程服务(需要 Node.js)。前往 Settings → Developer → Local MCP servers,点击 Edit Config,然后添加:

{
  "mcpServers": {
    "appwrite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
    }
  }
}

重启 Claude Desktop;该服务会显示在 Local MCP servers 下,并会打开 浏览器窗口以完成身份验证。

Claude Desktop 的 Local MCP servers 下运行的 Appwrite 服务

Cursor

编辑 ~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目)。

{
  "mcpServers": {
    "appwrite": {
      "url": "https://mcp.appwrite.io/"
    }
  }
}

Cursor 会提示你通过浏览器登录;随后,该服务会显示在 Settings → MCP 下, 其工具也会启用。

Cursor 的 MCP 设置中已连接的 Appwrite 服务

VS Code(GitHub Copilot)

编辑 .vscode/mcp.json(工作区),或通过命令面板 → MCP: Open User Configuration 编辑用户配置。

{
  "servers": {
    "appwrite": {
      "type": "http",
      "url": "https://mcp.appwrite.io/"
    }
  }
}
Codex

编辑 ~/.codex/config.toml。

[mcp_servers.appwrite]
url = "https://mcp.appwrite.io/"

然后从终端进行身份验证:

codex mcp login appwrite

在 Codex GUI 中,也可以从 MCP 设置添加服务——将 URL 设为 https://mcp.appwrite.io/,并将 token 和 header 字段留空(身份验证会通过浏览器完成):

Codex GUI 中的 Appwrite MCP 服务设置

OpenCode

编辑 opencode.json(项目)或 ~/.config/opencode/opencode.json(全局)。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "appwrite": {
      "type": "remote",
      "url": "https://mcp.appwrite.io/",
      "enabled": true
    }
  }
}
Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json。

{
  "mcpServers": {
    "appwrite": {
      "serverUrl": "https://mcp.appwrite.io/"
    }
  }
}
Gemini CLI
gemini mcp add --transport http appwrite https://mcp.appwrite.io/

或者编辑 ~/.gemini/settings.json(注意,键名是 httpUrl,而不是 url):

{
  "mcpServers": {
    "appwrite": {
      "httpUrl": "https://mcp.appwrite.io/"
    }
  }
}

Gemini CLI 会在首次连接时自动打开浏览器 OAuth 流程。若要重新进行身份验证, 请在会话中运行 /mcp auth appwrite。

Antigravity(CLI 和 2.0)

编辑 ~/.gemini/config/mcp_config.json(全局)或 .agents/mcp_config.json(项目工作区)。

{
  "mcpServers": {
    "appwrite": {
      "serverUrl": "https://mcp.appwrite.io/"
    }
  }
}

⚠️ 注意: Antigravity 对远程传输严格要求使用 serverUrl 键。使用 url 或 httpUrl 等旧字段会导致工具注册静默失败。

GitHub Copilot CLI
copilot mcp add --transport http appwrite https://mcp.appwrite.io/

也可以在会话中运行 /mcp add,或编辑 ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "appwrite": {
      "type": "http",
      "url": "https://mcp.appwrite.io/"
    }
  }
}

首次连接时会打开浏览器窗口进行身份验证。使用 /mcp 检查状态。

Zed

前往 Settings → AI → MCP Servers → Add Server → Add Remote Server,或将其添加到 settings.json(zed: open settings):

{
  "context_servers": {
    "appwrite": {
      "url": "https://mcp.appwrite.io/"
    }
  }
}

首次连接时,Zed 会提示你通过浏览器进行身份验证。

Warp

前往 Settings → Agents → MCP servers → + Add,选择基于 URL 的 服务类型,并输入 https://mcp.appwrite.io/。

首次连接时,Warp 会打开浏览器窗口进行身份验证。

JetBrains AI Assistant / Junie

JetBrains IDE 目前尚不支持远程 MCP 服务的 OAuth,因此需要通过 stdio 桥接 (需要 Node.js)。前往 Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add,切换到 JSON 视图,然后粘贴:

{
  "mcpServers": {
    "appwrite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
    }
  }
}

首次连接时会打开浏览器窗口进行身份验证。

Cline

Cline 目前尚不支持远程 MCP 服务的 OAuth,因此需要通过 stdio 桥接(需要 Node.js)。在 Cline 面板中,打开 MCP Servers 图标 → Configure 标签页 → Configure MCP Servers,然后添加:

{
  "mcpServers": {
    "appwrite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.appwrite.io/"]
    }
  }
}

首次连接时会打开浏览器窗口进行身份验证。

可自托管的 Appwrite

正在运行自己的 Appwrite 实例?在本地通过 stdio 运行 MCP 服务,并使用项目 API 密钥进行 身份验证。有关各客户端的设置说明,请参阅 docs/self-hosted.md。

文档

许可证

此 MCP 服务采用 MIT 许可证。详情请参阅 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。