Appwrite MCP Server

Appwrite MCP Server
官方

一个模型上下文协议服务器,允许 AI 助手与 Appwrite 的 API 交互,从而提供管理 Appwrite 项目中数据库、用户、函数、团队和其他资源的工具。

数据库
云平台
Python
访问服务器

Tools

databases_create_document

Create document

databases_create_email_attribute

Create email attribute

databases_create_enum_attribute

Create enum attribute

databases_create_float_attribute

Create float attribute

databases_create_index

Create index

databases_create_integer_attribute

Create integer attribute

users_create

Create user

users_create_argon2_user

Create user with Argon2 password

users_create_bcrypt_user

Create user with bcrypt password

users_create_jwt

Create user JWT

users_create_md5_user

Create user with MD5 password

users_create_mfa_recovery_codes

Create MFA recovery codes

users_create_ph_pass_user

Create user with PHPass password

databases_create_ip_attribute

Create IP address attribute

users_create_scrypt_modified_user

Create user with Scrypt modified password

databases_create_relationship_attribute

Create relationship attribute

databases_update_datetime_attribute

Update dateTime attribute

databases_update_document

Update document

databases_update_email_attribute

Update email attribute

users_create_scrypt_user

Create user with Scrypt password

users_create_session

Create session

users_create_sha_user

Create user with SHA password

users_create_target

Create user target

users_delete

Delete user

users_create_token

Create token

users_delete_identity

Delete identity

users_delete_mfa_authenticator

Delete authenticator

users_delete_session

Delete user session

users_delete_sessions

Delete user sessions

users_delete_target

Delete user target

users_get

Get user

users_get_mfa_recovery_codes

Get MFA recovery codes

users_get_prefs

Get user preferences

users_get_target

Get user target

users_list

List users

users_update_status

Update user status

users_list_identities

List identities

users_list_logs

List user logs

users_list_memberships

List user memberships

users_list_mfa_factors

List factors

users_list_sessions

List user sessions

users_list_targets

List user targets

users_update_email

Update email

users_update_email_verification

Update email verification

users_update_labels

Update user labels

users_update_mfa

Update MFA

users_update_mfa_recovery_codes

Regenerate MFA recovery codes

users_update_name

Update name

users_update_password

Update password

users_update_phone

Update phone

users_update_phone_verification

Update phone verification

users_update_prefs

Update user preferences

users_update_target

Update user target

databases_create

Create database

databases_create_boolean_attribute

Create boolean attribute

databases_create_collection

Create collection

databases_create_datetime_attribute

Create datetime attribute

databases_get_document

Get document

databases_update_collection

Update collection

databases_get_index

Get index

databases_update_enum_attribute

Update enum attribute

databases_list

List databases

databases_list_attributes

List attributes

databases_list_collections

List collections

databases_list_documents

List documents

databases_list_indexes

List indexes

databases_update

Update database

databases_update_boolean_attribute

Update boolean attribute

databases_create_string_attribute

Create string attribute

databases_create_url_attribute

Create URL attribute

databases_delete

Delete database

databases_delete_attribute

Delete attribute

databases_delete_collection

Delete collection

databases_delete_document

Delete document

databases_delete_index

Delete index

databases_get

Get database

databases_get_attribute

Get attribute

databases_get_collection

Get collection

databases_update_float_attribute

Update float attribute

databases_update_integer_attribute

Update integer attribute

databases_update_ip_attribute

Update IP address attribute

databases_update_relationship_attribute

Update relationship attribute

databases_update_string_attribute

Update string attribute

databases_update_url_attribute

Update URL attribute

README

Appwrite MCP 服务器

<!-- 封面图片将在此处显示,一旦可用 -->

<a href="https://glama.ai/mcp/servers/xkj2px7r0v"> <img width="380" height="200" src="https://glama.ai/mcp/servers/xkj2px7r0v/badge" alt="Appwrite MCP server" /> </a>

概述

一个用于与 Appwrite API 交互的模型上下文协议服务器。 此服务器提供工具来管理 Appwrite 项目中的数据库、用户、函数、团队等。

快速链接

配置

在启动 MCP 服务器之前,您必须设置一个 Appwrite 项目 并创建一个启用了必要作用域的 API 密钥。

在您的工作目录中创建一个 .env 文件并添加以下内容:

APPWRITE_PROJECT_ID=your-project-id
APPWRITE_API_KEY=your-api-key
APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1

然后,打开您的终端并运行以下命令

Linux 和 MacOS

source .env

Windows

命令提示符

for /f "tokens=1,2 delims==" %A in (.env) do set %A=%B

PowerShell

Get-Content .\.env | ForEach-Object {
  if ($_ -match '^(.*?)=(.*)$') {
    [System.Environment]::SetEnvironmentVariable($matches[1], $matches[2], "Process")
  }
}

安装

使用 uv (推荐)

当使用 uv 时,无需进行特定安装。 我们将使用 uvx 直接运行 mcp-server-appwrite

uvx mcp-server-appwrite [args]

使用 pip

pip install mcp-server-appwrite

然后使用以下命令运行服务器

python -m mcp_server_appwrite [args]

命令行参数

uvpip 设置过程都需要某些参数才能为各种 Appwrite API 启用 MCP 工具。

启用 MCP 工具后,该工具的定义将传递给 LLM,从而占用模型可用上下文窗口中的令牌。 因此,有效上下文窗口会减小。

默认的 Appwrite MCP 服务器仅附带启用的数据库工具(我们最常用的 API),以保持在这些限制范围内。 可以使用以下标志启用其他工具。

参数 描述
--databases 启用数据库 API
--users 启用用户 API
--teams 启用团队 API
--storage 启用存储 API
--functions 启用函数 API
--messaging 启用消息传递 API
--locale 启用区域设置 API
--avatars 启用头像 API
--all 启用所有 Appwrite API

与 Claude Desktop 一起使用

在 Claude Desktop 应用程序中,打开应用程序的设置页面(在 Windows 上按 CTRL + , 或在 MacOS 上按 CMD + ,),然后转到开发者选项卡。 单击编辑配置按钮将带您进入 claude_desktop_config.json 文件,您必须在其中添加以下内容:

{
  "mcpServers": {
    "appwrite": {
      "command": "uvx",
      "args": [
        "mcp-server-appwrite"
      ],
      "env": {
        "APPWRITE_PROJECT_ID": "your-project-id",
        "APPWRITE_API_KEY": "your-api-key",
        "APPWRITE_ENDPOINT": "https://cloud.appwrite.io/v1" // Optional
      }
    }
  }
}

注意:如果您看到 uvx ENOENT 错误,请确保将 uvx 添加到系统上的 PATH 环境变量,或者在配置文件中使用 uvx 安装的完整路径。

成功配置后,您应该能够在 Claude Desktop 的可用服务器列表中看到该服务器。

Claude Desktop 配置

Cursor 一起使用

转到 Cursor Settings > MCP 并单击添加新的 MCP 服务器。 选择类型为 Command 并将以下命令添加到Command字段。

  • MacOS
env APPWRITE_API_KEY=your-api-key env APPWRITE_PROJECT_ID=your-project-id uvx mcp-server-appwrite
  • Windows
cmd /c SET APPWRITE_PROJECT_ID=your-project-id && SET APPWRITE_API_KEY=your-api-key && uvx mcp-server-appwrite

Cursor 设置

Windsurf Editor 一起使用

转到 Windsurf Settings > Cascade > Model Context Protocol (MCP) Servers 并单击查看原始配置。 更新 mcp_config.json 文件以包含以下内容:

{
  "mcpServers": {
    "appwrite": {
      "command": "uvx",
      "args": [
        "mcp-server-appwrite"
      ],
      "env": {
        "APPWRITE_PROJECT_ID": "your-project-id",
        "APPWRITE_API_KEY": "your-api-key",
        "APPWRITE_ENDPOINT": "https://cloud.appwrite.io/v1" // Optional
      }
    }
  }
}

Windsurf 设置

本地开发

克隆存储库

git clone https://github.com/appwrite/mcp.git

安装 uv

  • Linux 或 MacOS
curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

准备虚拟环境

首先,创建一个虚拟环境。

uv venv

接下来,激活虚拟环境。

  • Linux 或 MacOS
source .venv/bin/activate
  • Windows
.venv\Scripts\activate

运行服务器

uv run -v --directory ./ mcp-server-appwrite

调试

您可以使用 MCP 检查器来调试服务器。

npx @modelcontextprotocol/inspector \
  uv \
  --directory . \
  run mcp-server-appwrite

在运行检查器之前,请确保您的 .env 文件已正确配置。 然后,您可以访问 http://localhost:5173 上的检查器。

许可证

此 MCP 服务器已获得 MIT 许可证的许可。 这意味着您可以自由使用、修改和分发该软件,但须遵守 MIT 许可证的条款和条件。 有关更多详细信息,请参阅项目存储库中的 LICENSE 文件。

推荐服务器

DuckDuckGo MCP Server

DuckDuckGo MCP Server

一个模型上下文协议 (MCP) 服务器,通过 DuckDuckGo 提供网页搜索功能,并具有内容获取和解析的附加功能。

精选
Python
contentful-mcp

contentful-mcp

在你的 Contentful Space 中更新、创建、删除内容、内容模型和资源。

精选
TypeScript
Supabase MCP Server

Supabase MCP Server

一个模型上下文协议(MCP)服务器,它提供对 Supabase 管理 API 的编程访问。该服务器允许 AI 模型和其他客户端通过标准化的接口来管理 Supabase 项目和组织。

精选
JavaScript
YouTube Transcript MCP Server

YouTube Transcript MCP Server

这个服务器用于获取指定 YouTube 视频 URL 的字幕,从而可以与 Goose CLI 或 Goose Desktop 集成,进行字幕提取和处理。

精选
Python
MCP DuckDB Knowledge Graph Memory Server

MCP DuckDB Knowledge Graph Memory Server

一个为 Claude 设计的记忆服务器,它使用 DuckDB 存储和检索知识图谱数据,从而增强了对话的性能和查询能力,并能持久保存用户信息。

精选
TypeScript
Tavily MCP Server

Tavily MCP Server

使用 Tavily 的搜索 API 提供 AI 驱动的网络搜索功能,使 LLM 能够执行复杂的网络搜索、获得问题的直接答案以及搜索最近的新闻文章。

精选
Python
Metabase MCP Server

Metabase MCP Server

使人工智能助手能够与 Metabase 数据库和仪表板进行交互,允许用户通过自然语言列出和执行查询、访问数据可视化以及与数据库资源进行交互。

精选
JavaScript
Airtable MCP Server

Airtable MCP Server

一个模型上下文协议(Model Context Protocol,MCP)服务器,通过 Claude Desktop 或其他 MCP 客户端,为以编程方式管理 Airtable 数据库、表格、字段和记录提供工具。

精选
JavaScript
mcp-shodan

mcp-shodan

用于查询 Shodan API 和 Shodan CVEDB 的 MCP 服务器。该服务器提供 IP 查询、设备搜索、DNS 查询、漏洞查询、CPE 查询等工具。

精选
JavaScript
Azure MCP Server

Azure MCP Server

通过 Claude Desktop 实现与 Azure 服务的自然语言交互,支持资源管理、订阅处理和租户选择,并提供安全身份验证。

官方
本地
TypeScript