mcp-server-appwrite

🚀 Appwrite MCP 服务器

这是一个用于与 Appwrite API 交互的模型上下文协议（Model Context Protocol）服务器。它提供了管理数据库、用户、函数、团队等功能的工具，助力开发者更高效地进行相关操作。

🚀 快速开始

你可以通过以下快速链接，快速定位到你需要的内容：

• 配置
• 安装
• 集成开发环境：
  • VS Code
  • PyCharm
  • WebStorm
• 本地开发

📦 安装指南

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

📚 详细文档

配置

要使用 MCP 服务器，请按照以下步骤进行配置：

1. 在项目根目录下创建一个 .env 文件。
2. 将以下内容添加到 .env 文件中：

APPWRITE_PROJECT_ID=your_project_id
APPWRITE_API_KEY=your_api_key

3. 根据需要更新 APPWRITE_ENDPOINT 环境变量（可选）。

集成开发环境

VS Code

1. 在项目根目录下创建或更新 settings.json 文件。
2. 添加以下内容：

{
  "mcp.servers.appwrite": {
    "command": "uv",
    "args": [
      "mcp-server-appwrite"
    ],
    "env": {
      "APPWRITE_PROJECT_ID": "your_project_id",
      "APPWRITE_API_KEY": "your_api_key"
    }
  }
}

PyCharm

1. 打开项目设置。
2. 转到 MCP 选项卡。
3. 添加以下内容：

{
  "mcpServers": {
    "appwrite": {
      "command": "uv",
      "args": [
        "mcp-server-appwrite"
      ],
      "env": {
        "APPWRITE_PROJECT_ID": "your_project_id",
        "APPWRITE_API_KEY": "your_api_key"
      }
    }
  }
}

WebStorm

1. 打开项目设置。
2. 转到 MCP 选项卡。
3. 添加以下内容：

{
  "mcpServers": {
    "appwrite": {
      "command": "uv",
      "args": [
        "mcp-server-appwrite"
      ],
      "env": {
        "APPWRITE_PROJECT_ID": "your_project_id",
        "APPWRITE_API_KEY": "your_api_key"
      }
    }
  }
}

本地开发

克隆仓库

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

安装虚拟环境

1. 创建虚拟环境：

uv venv

2. 激活虚拟环境：
   • Linux 或 MacOS：

source .venv/bin/activate

- **Windows**：

.venv\Scripts\activate

3. 运行服务器：

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

调试

使用 MCP inspector 进行调试：

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

确保 .env 文件已正确配置。调试完成后，访问 http://localhost:5173 查看结果。

📄 许可证

该 MCP 服务器根据 MIT 许可证分发。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的 LICENSE 文件。