Appwrite MCP server

基本能力

产品定位

Appwrite MCP server 是一个用于与Appwrite API交互的模型上下文协议服务器，旨在简化Appwrite项目的管理和开发流程。

核心功能

• 管理Appwrite项目中的数据库、用户、函数、团队等功能
• 支持多种IDE集成（Claude Desktop、Cursor、Windsurf Editor）
• 提供本地开发和调试工具
• 支持多种API（Databases、Users、Teams、Storage、Functions、Messaging、Locale、Avatars）

适用场景

• 开发者在Appwrite项目中进行数据库管理
• 需要与Appwrite API交互的自动化任务
• 团队协作和用户管理
• 本地开发和调试Appwrite项目

工具列表

• Databases API: 管理Appwrite项目中的数据库
• Users API: 管理用户信息
• Teams API: 管理团队信息
• Storage API: 管理存储资源
• Functions API: 管理函数
• Messaging API: 管理消息
• Locale API: 管理本地化信息
• Avatars API: 管理头像

常见问题解答

• uvx ENOENT错误: 确保uvx已添加到系统的PATH环境变量中，或在配置文件中使用uvx的完整路径。
• 环境变量配置: 确保.env文件正确配置了APPWRITE_PROJECT_ID和APPWRITE_API_KEY。

使用教程

使用依赖

1. 创建一个Appwrite项目并生成API密钥。
2. 在项目目录中创建.env文件，并添加以下内容： env APPWRITE_PROJECT_ID=your-project-id APPWRITE_API_KEY=your-api-key APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1
3. 加载环境变量：
4. Linux和MacOS: sh source .env
5. Windows (Command Prompt): cmd for /f "tokens=1,2 delims==" %A in (.env) do set %A=%B
6. Windows (PowerShell): powershell Get-Content .\.env | ForEach-Object { if ($_ -match '^(.*?)=(.*)$') { [System.Environment]::SetEnvironmentVariable($matches[1], $matches[2], "Process") } }

安装教程

1. 使用uv安装（推荐）: bash uvx mcp-server-appwrite [args]
2. 使用pip安装: bash pip install mcp-server-appwrite python -m mcp_server_appwrite [args]

调试方式

1. 使用MCP inspector调试服务器: bash npx @modelcontextprotocol/inspector \ uv \ --directory . \ run mcp-server-appwrite
2. 访问调试界面:
3. 打开浏览器，访问http://localhost:5173。

本地开发

1. 克隆仓库: bash git clone https://github.com/appwrite/mcp.git
2. 安装uv:
3. Linux或MacOS: bash curl -LsSf https://astral.sh/uv/install.sh | sh
4. Windows (PowerShell): powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
5. 创建并激活虚拟环境: bash uv venv source .venv/bin/activate # Linux/MacOS .venv\Scripts\activate # Windows
6. 运行服务器: bash uv run -v --directory ./ mcp-server-appwrite

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。