Appwrite

🚀 Appwrite MCP 服務器

Appwrite MCP 服務器是一個用於與 Appwrite API 進行交互的工具，藉助模型上下文協議（MCP），它能讓你直接與 Appwrite 平臺集成，為開發工作提供便利。

🚀 快速開始

若想快速上手 Appwrite MCP 服務器，你需要先完成配置與安裝，接著將其集成到所需的應用中，以下是詳細步驟。

✨ 主要特性

• 通過模型上下文協議（MCP）直接與 Appwrite 平臺集成。
• 支持多種安裝方式，如使用 uv 或 pip。
• 可集成到 Claude Desktop、Cursor、Windsurf Editor 等應用中。

📦 安裝指南

使用 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 許可證，您可以自由使用、修改和分發。