Appwrite

🚀 Appwrite MCP 服务器

Appwrite MCP 服务器是一个用于与 Appwrite API 进行交互的 Model Context Protocol (MCP) 服务器。它允许您通过模型上下文协议（MCP）直接与 Appwrite 平台集成，为开发带来便利。

🚀 快速开始

要使用 Appwrite MCP 服务器，您需要进行一些配置和安装操作，以下是详细步骤。

✨ 主要特性

• 支持通过模型上下文协议（MCP）直接与 Appwrite 平台集成。
• 提供多种安装和集成方式，方便不同环境和工具的使用。

📦 安装指南

使用 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"

使用 pip

pip install mcp-server-appwrite

📚 详细文档

配置

在项目根目录下创建一个 .env 文件，并添加以下内容：

APPWRITE_API_KEY=你的 API 密钥
APPWRITE_PROJECT_ID=你的项目 ID
APPWRITE_ENDPOINT=https://api.appwrite.io （可选，默认为该值）

集成

Claude Desktop

1. 打开 Claude Desktop 的设置。
2. 在 Settings > MCP 中，点击 Add new MCP server。
3. 选择类型为 Command，并在 Command 字段中添加以下内容：
   • MacOS

env APPWRITE_API_KEY=你的 API 密钥 env APPWRITE_PROJECT_ID=你的项目 ID uvx mcp-server-appwrite

- **Windows**

cmd /c SET APPWRITE_PROJECT_ID=你的项目 ID && SET APPWRITE_API_KEY=你的 API 密钥 && uvx mcp-server-appwrite

Cursor

1. 打开 Cursor 的设置。
2. 在 Settings > Model Context Protocol (MCP) 中，点击 View raw config。
3. 更新 mcp_config.json 文件：

{
    "mcpServers": {
        "appwrite": {
            "command": "uvx",
            "args": [
                "mcp-server-appwrite"
            ],
            "env": {
                "APPWRITE_PROJECT_ID": "你的项目 ID",
                "APPWRITE_API_KEY": "你的 API 密钥",
                "APPWRITE_ENDPOINT": "https://api.appwrite.io" // 可选，默认为该值
            }
        }
    }
}

Windsurf Editor

1. 打开 Windsurf 的设置。
2. 在 Settings > Cascade > Model Context Protocol (MCP) Servers 中，点击 View raw config。
3. 更新 mcp_config.json 文件：

{
    "mcpServers": {
        "appwrite": {
            "command": "uvx",
            "args": [
                "mcp-server-appwrite"
            ],
            "env": {
                "APPWRITE_PROJECT_ID": "你的项目 ID",
                "APPWRITE_API_KEY": "你的 API 密钥",
                "APPWRITE_ENDPOINT": "https://api.appwrite.io" // 可选，默认为该值
            }
        }
    }
}

本地开发

克隆仓库

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"

设置虚拟环境

1. 创建并激活虚拟环境：
   • Linux 或 MacOS

uv venv
source .venv/bin/activate

- **Windows**

.venv\Scripts\activate

2. 运行服务器：

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

调试

使用 MCP 检查工具进行调试：

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

打开浏览器访问 http://localhost:8090。

📄 许可证

该软件使用 MIT 许可证，您可以自由使用、修改和分发。