Servidor MCP de Appwrite

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.

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

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
Confluence MCP
cosmix
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.
Last updated -
9
3
TypeScript
MIT License
Office Word MCP Server
GongRzhe
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to create, read, edit, and format Microsoft Word documents through standardized tools and resources.
Last updated -
16
259
Python
MIT License
MCP Toolkit
zxfgds
-
security
F
license
-
quality
A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
Last updated -
16
TypeScript

View all related MCP servers

Appwrite MCP Server