appwrite-console-mcp
# appwrite-console-mcp
MCP-сервер с рут-доступом ко всем проектам Appwrite. Логинится рут-аккаунтом в
контексте `console`, а для данных конкретного проекта на лету выпускает ключ со
всеми скоупами. Один эндпоинт = весь инстанс + управление проектами.
## Инструменты
- `appwrite_request` — универсальный вызов: `target` (`console` или ID проекта),
`method`, `path` (без `/v1`), опционально `query` / `body`.
- `list_projects`, `list_organizations`, `create_project`, `delete_project`.
## Переменные окружения
- `APPWRITE_ENDPOINT` — напр. `https://appwrite.example.com/v1`
- `APPWRITE_EMAIL`, `APPWRITE_PASSWORD` — рут-аккаунт (MFA выключен)
- `MCP_SECRET` — токен в пути HTTP-эндпоинта (авторизация коннектора)
- `PORT` — по умолчанию 8000
## Запуск (Docker / Coolify)
Деплой из репозитория как Dockerfile. Контейнер поднимает MCP по stdio и отдаёт
его как Streamable HTTP через supergateway. Коннектор Claude.ai:
`https://<домен>/<MCP_SECRET>/mcp`.
Локально (stdio, без моста):
APPWRITE_ENDPOINT=... APPWRITE_EMAIL=... APPWRITE_PASSWORD=... node index.mjs
TDQS
Scored across 5 tools
There is clear overlap between the generic appwrite_request tool and the specific CRUD tools, as appwrite_request can also create and delete projects. Agents may struggle to decide whether to use the generic or dedicated tool for these operations.
Most tools follow a verb_noun pattern (create_project, delete_project, list_organizations, list_projects), but appwrite_request breaks this pattern with a noun_noun style, causing inconsistency in the overall naming scheme.
With only 5 tools, the set feels thin for an Appwrite console management server. However, the generic appwrite_request tool can cover many missing operations, making the count borderline acceptable rather than severely mismatched.
The dedicated tools only cover a narrow subset of operations (create, delete, list projects and list organizations). Many expected operations like update project or manage databases are absent, leaving significant gaps that force reliance on the generic tool.