Servidor MCP de AppWrite

Name: Appwrite MCP Server
Author: 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.

Related MCP server: MCP Toolkit

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.

Argumento	Descripción
`--databases`	Habilita la API de bases de datos
`--users`	Habilita la API de usuarios
`--teams`	Habilita la API de Teams
`--storage`	Habilita la API de almacenamiento
`--functions`	Habilita la API de funciones
`--messaging`	Habilita la API de mensajería
`--locale`	Habilita la API de configuración regional
`--avatars`	Habilita la API de avatares
`--all`	Habilita 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.

Configuración del escritorio de Claude

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

Configuración del cursor

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 } } } }

Configuración de windsurf

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.

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Tools

View all tools

Appwrite MCP Server

Servidor MCP de AppWrite

Descripción general

Enlaces rápidos