Skip to main content
Glama
Sign In
enesjakozh

Appwrite MCP Server

Official
by appwrite
GitHub
Python
MIT License
29
  • Linux
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides tools to manage Appwrite resources including databases, users, functions, teams, storage, messaging, locale, and avatars through the Appwrite API.

Servidor MCP de AppWrite

Descripción general

Un servidor de Protocolo de Contexto de Modelo para interactuar con la API de Appwrite. Este servidor proporciona herramientas para gestionar bases de datos, usuarios, funciones, equipos y más dentro de tu proyecto de Appwrite.

Enlaces rápidos

Configuración

Antes de iniciar el servidor MCP, debe configurar un proyecto Appwrite y crear una clave API con los ámbitos necesarios habilitados.

Cree un archivo .env en su directorio de trabajo y agregue lo siguiente:

APPWRITE_PROJECT_ID=your-project-id APPWRITE_API_KEY=your-api-key APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1

Luego, abre tu terminal y ejecuta el siguiente comando

Linux y MacOS

source .env

Ventanas

Símbolo del sistema

for /f "tokens=1,2 delims==" %A in (.env) do set %A=%B

PowerShell

Get-Content .\.env | ForEach-Object { if ($_ -match '^(.*?)=(.*)$') { [System.Environment]::SetEnvironmentVariable($matches[1], $matches[2], "Process") } }

Instalación

Uso de uv (recomendado)

Al usar uv , no se requiere ninguna instalación específica. Usaremos uvx para ejecutar directamente mcp-server-appwrite .

uvx mcp-server-appwrite [args]

Usando pip

pip install mcp-server-appwrite

Luego ejecute el servidor usando

python -m mcp_server_appwrite [args]

Argumentos de la línea de comandos

Los procesos de configuración uv y pip requieren ciertos argumentos para habilitar las herramientas MCP para varias API de Appwrite.

Al habilitar una herramienta MCP, su definición se transmite al LLM, utilizando tokens de la ventana de contexto disponible del modelo. Como resultado, se reduce la ventana de contexto efectiva.

El servidor MCP de Appwrite predeterminado se entrega con solo las herramientas de bases de datos (nuestra API más utilizada) habilitadas para cumplir con estos límites. Se pueden habilitar herramientas adicionales usando las opciones a continuación.

ArgumentoDescripción
--databasesHabilita la API de bases de datos
--usersHabilita la API de usuarios
--teamsHabilita la API de Teams
--storageHabilita la API de almacenamiento
--functionsHabilita la API de funciones
--messagingHabilita la API de mensajería
--localeHabilita la API de configuración regional
--avatarsHabilita la API de avatares
--allHabilita todas las API de Appwrite

Uso con Claude Desktop

En la aplicación Claude Desktop, abra la página de Configuración (presione CTRL + , en Windows o CMD + , en macOS) y vaya a la pestaña Desarrollador . Al hacer clic en el botón "Editar configuración", accederá al archivo claude_desktop_config.json , donde debe agregar lo siguiente:

{ "mcpServers": { "appwrite": { "command": "uvx", "args": [ "mcp-server-appwrite" ], "env": { "APPWRITE_PROJECT_ID": "your-project-id", "APPWRITE_API_KEY": "your-api-key", "APPWRITE_ENDPOINT": "https://cloud.appwrite.io/v1" // Optional } } } }

Nota: En caso de que vea un error uvx ENOENT , asegúrese de agregar uvx a la variable de entorno PATH en su sistema o usar la ruta completa a su instalación uvx en el archivo de configuración.

Una vez realizada la configuración correctamente, debería poder ver el servidor en la lista de servidores disponibles en Claude Desktop.

Uso con cursor

Vaya a Settings > MCP y haga clic en Agregar nuevo servidor MCP . Seleccione el tipo " Command y agréguelo en el campo "Comando" .

  • Sistema operativo Mac
env APPWRITE_API_KEY=your-api-key env APPWRITE_PROJECT_ID=your-project-id uvx mcp-server-appwrite
  • Ventanas
cmd /c SET APPWRITE_PROJECT_ID=your-project-id && SET APPWRITE_API_KEY=your-api-key && uvx mcp-server-appwrite

Uso con Windsurf Editor

Dirígete a Settings > Cascade > Model Context Protocol (MCP) Servers y haz clic en Ver configuración sin procesar . Actualiza el archivo mcp_config.json para incluir lo siguiente:

{ "mcpServers": { "appwrite": { "command": "uvx", "args": [ "mcp-server-appwrite" ], "env": { "APPWRITE_PROJECT_ID": "your-project-id", "APPWRITE_API_KEY": "your-api-key", "APPWRITE_ENDPOINT": "https://cloud.appwrite.io/v1" // Optional } } } }

Desarrollo local

Clonar el repositorio

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

Instalar uv

  • Linux o MacOS
curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Preparar el entorno virtual

Primero, crea un entorno virtual.

uv venv

A continuación, active el entorno virtual.

  • Linux o MacOS
source .venv/bin/activate
  • Ventanas
.venv\Scripts\activate

Ejecutar el servidor

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

Depuración

Puede utilizar el inspector MCP para depurar el servidor.

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

Asegúrese de que su archivo .env esté configurado correctamente antes de ejecutar el inspector. Puede acceder al inspector en http://localhost:5173 .

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA interactuar con la API de Appwrite, proporcionando herramientas para administrar bases de datos, usuarios, funciones, equipos y otros recursos dentro de los proyectos de Appwrite.

  1. Overview
    1. Quick Links
      1. Configuration
        1. Linux and MacOS
        2. Windows
      2. Installation
        1. Using uv (recommended)
        2. Using pip
        3. Command-line arguments
      3. Usage with Claude Desktop
        1. Usage with Cursor
          1. Usage with Windsurf Editor
            1. Local Development
              1. Clone the repository
              2. Install uv
              3. Prepare virtual environment
              4. Run the server
            2. Debugging
              1. License

                Related Resources

                Appeared in Searches

                ID: xkj2px7r0v