MCP on self-host is not working

Hello all, I'm trying to setup MCP with Claude Code on my self-hosted Appwrite instance 1.9.5.

What I did:

Installed uv
Installed Claude Appwrite plugin with claude plugin install appwrite@claude-plugins-official
Ran this command to setup config

TypeScript

claude mcp add-json appwrite-api '{"command":"uvx","args":["mcp-server-appwrite"],"env":{"APPWRITE_PROJECT_ID": "<ID>", "APPWRITE_API_KEY": "<API_KEY>", "APPWRITE_ENDPOINT": "https://example.appwrite/v1"}}'

On Claude Code, I try to go on plugins, then installed and "reconnect" and give this error : "Failed to reconnect to appwrite-api: -32000"

Note:

Trying to ran a curl on /health endpoint with the same api key and got "PASS".
Enabled only Databases read & Functions read permissions for this key.

Do I need to explicitly enable something on .env file? Thanks

TL;DR

MCP on self-host is not working due to migration issue from 1.9.0. Solution: Update to the latest Python SDK version and MCP release v0.8.25, which fixed the problem.

<@206687499966218240> can you try using

claude mcp add --transport http appwrite https://mcp.appwrite.io/

Thanks but It only connect to Appwrite cloud not my self hosted instance no?

I need to authentificate with my Appwrite cloud credentials, it was successful but it only interract with my cloud project <@743532656767270934>

sorry yeah mb, follow these sh docs - https://github.com/appwrite/mcp/blob/main/docs/self-hosted.md

Thanks <@743532656767270934> but I can't achieve to make it working... My Claude config is :

"mcpServers": { "appwrite-api": { "command": "uvx", "args": [ "mcp-server-appwrite" ], "env": { "APPWRITE_PROJECT_ID": "XXXXX-prod", "APPWRITE_API_KEY": "XXXXXX", "APPWRITE_ENDPOINT": "https://XXXXX/v1" } } },

And always have this error Failed to reconnect to appwrite-api: -32000

Is there a way using docker to see the status of MCP server running?

i see, something seems wrong. thanks for reporting! will take a look soon

Thanks

<@206687499966218240> releasing this pr - https://github.com/appwrite/mcp/pull/83

it should show you proper error instead of a generic reconnect error

Thanks! Need to reinstall the mcp plugin I guess to try this?

since command uses uvx it should default to latest, might need a cache clear if it doesnt work automatically

<@743532656767270934> After debugging a lot, it seems MCP try to parse from 1.9.6 servers but "policies, archives" props are missing from TableDB. I think it's a migration issue on 1.9.0 no?