mcpField
A
Appwrite MCP server

Appwrite MCP server

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

关于 Appwrite MCP server

Appwrite MCP server 是 Appwrite 的官方 MCP 服务,将数据库、用户、函数、团队和存储等 Appwrite API 以工具形式提供给 MCP 客户端。远程服务通过浏览器授权连接,无需手动复制密钥。

主要功能

  1. 01托管的远程 MCP 服务
  2. 02通过浏览器 OAuth 授权登录
  3. 03覆盖数据库、用户、函数、存储等 API
  4. 04支持可自托管的 Appwrite 实例

适用场景

  1. 01在 AI 编码工具中管理 Appwrite 项目后端
  2. 02通过自然语言查询数据库或用户信息
  3. 03在本地环境连接自托管 Appwrite 实例

MCP 相关

该项目是 MCP 服务,向 MCP 客户端暴露 Appwrite API 的工具,客户端可通过远程地址或 stdio 桥接方式连接。

配置

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

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

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

安装包
pypimcp-server-appwrite2.1.2

工具

详细介绍

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 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。