Appwrite MCP 服务器

概述

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

配置

创建 .env 文件

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

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

安装

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

集成

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 许可证，您可以自由使用、修改和分发。