返回 MCP 目录
public公开dns本地运行

mcp-server-appwrite

Appwrite MCP服务器是一个用于与Appwrite API交互的模型上下文协议服务,提供管理数据库、用户、函数、团队等功能。

article

README

🚀 Appwrite MCP 服务器

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

🚀 快速开始

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

📦 安装指南

使用 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
  1. 根据需要更新 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
  1. 激活虚拟环境:
    • Linux 或 MacOS
source .venv/bin/activate
- **Windows**:
.venv\Scripts\activate
  1. 运行服务器:
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 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端