mcpField
M
mcp-for-api

mcp-for-api

本地服务
github.com/appwrite云与基础设施72今天更新
代码仓库

关于 mcp-for-api

mcp-for-api 是 Appwrite 的 MCP 服务，将 Appwrite API 中的数据库、用户、函数、团队和存储等功能以工具形式提供给 MCP 客户端。该项目面向使用 Appwrite 的开发者，托管服务通过浏览器授权连接。

主要功能

  1. 01托管服务通过浏览器 OAuth 授权连接
  2. 02暴露数据库、用户、函数、团队和存储等 API
  3. 03支持可自托管的 Appwrite 实例
  4. 04内置文档搜索工具 appwrite_search_docs

适用场景

  1. 01通过 AI 客户端管理 Appwrite 项目中的数据库和用户
  2. 02在编码会话中调用 Appwrite 函数与存储

MCP 相关

该项目是 MCP 服务，将 Appwrite API 的功能作为工具暴露给 MCP 客户端调用。文档列出了 Claude Code、Cursor、VS Code、Codex 等多款客户端的配置方法。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "appwrite-mcp-for-api": {
      "command": "uvx",
      "args": [
        "mcp-server-appwrite"
      ]
    }
  }
}
启动命令uvx mcp-server-appwrite

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-server-appwrite0.2.8

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

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