关于 Appwrite MCP server
Appwrite MCP server 是 Appwrite 的官方 MCP 服务,将数据库、用户、函数、团队和存储等 Appwrite API 以工具形式提供给 MCP 客户端。远程服务通过浏览器授权连接,无需手动复制密钥。
主要功能
- 01托管的远程 MCP 服务
- 02通过浏览器 OAuth 授权登录
- 03覆盖数据库、用户、函数、存储等 API
- 04支持可自托管的 Appwrite 实例
适用场景
- 01在 AI 编码工具中管理 Appwrite 项目后端
- 02通过自然语言查询数据库或用户信息
- 03在本地环境连接自托管 Appwrite 实例
MCP 相关
该项目是 MCP 服务,向 MCP 客户端暴露 Appwrite API 的工具,客户端可通过远程地址或 stdio 桥接方式连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.appwrite.io/claude mcp add --transport http appwrite https://mcp.appwrite.io/{"mcpServers":{"appwrite":{"type":"http","url":"https://mcp.appwrite.io/"}}}在 Cursor 中打开{"servers":{"appwrite":{"type":"http","url":"https://mcp.appwrite.io/"}}}在 VS Code 中打开{"mcpServers":{"appwrite":{"type":"http","url":"https://mcp.appwrite.io/"}}}{"mcpServers":{"appwrite":{"serverUrl":"https://mcp.appwrite.io/"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Appwrite MCP 服务
一个用于 Appwrite 的 Model Context Protocol 服务。 它将 Appwrite 的 API——数据库、用户、函数、团队、存储等—— 作为 MCP 客户端可调用的工具提供。
连接托管服务 https://mcp.appwrite.io/,并通过浏览器完成身份验证。
首次连接时,客户端会打开 Appwrite 授权页面;批准所需权限范围后即可连接。无需
复制任何密钥。常用的 https://mcp.appwrite.io/mcp URL 也受支持,并会
连接到同一服务。

连接客户端
选择下方的客户端。每种方式都会添加托管的 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 下,并会打开 浏览器窗口以完成身份验证。

Cursor
编辑 ~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目)。
{
"mcpServers": {
"appwrite": {
"url": "https://mcp.appwrite.io/"
}
}
}
Cursor 会提示你通过浏览器登录;随后,该服务会显示在 Settings → MCP 下, 其工具也会启用。

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 字段留空(身份验证会通过浏览器完成):

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。
文档
- 工具概览 — 向模型公开的工具以及 Appwrite 内部目录。
- 云端身份验证的工作原理 — OAuth 2.1 流程。
- 文档搜索 — 进程内的
appwrite_search_docs工具及其索引重建方法。 - 事件 — MCP Events:订阅 Appwrite 项目中的变更的 Webhook (正在开发中,尚不可用)。
- 可自托管的 Appwrite — 使用项目 API 密钥在本地运行服务。
- 本地开发 — 在本地运行、测试和调试 服务。
- AGENTS.md — 完整的贡献指南和提交 PR 前检查清单。
许可证
此 MCP 服务采用 MIT 许可证。详情请参阅 LICENSE 文件。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。