用 Appwrite 一键部署无状态 MCP 服务器

核心特性与开箱即用：
基于官方 Python MCP SDK（固定 mcp==2.0.0 版本），提供 echo 和 add 两个演示工具，可立即验证连通性。
使用 Streamable HTTP 传输，支持无状态 JSON-RPC，完全兼容 MCP 2026-07-28 规范，同时向后兼容旧版握手。
可选身份验证：通过设置环境变量 MCP_AUTH_MODE=bearer 和 MCP_AUTH_TOKEN 即可启用 Bearer Token 保护。
零运维：函数的域名就是 MCP 服务地址，TLS、部署、伸缩、日志均由 Appwrite 托管。
部署与连接：
在 Appwrite 控制台 Functions > Templates 中搜索 “MCP server” 并创建，可按需配置环境变量（服务器名、认证等）。
部署后获得 https://<函数名>.appwrite.run 域名。
客户端只需将该 URL 加入配置即可调用，例如在 Claude Code 中执行 claude mcp add --transport http my-mcp <URL>。
编写自定义工具：
在 src/app.py 中用 @server.tool() 装饰器注册 Python 函数，类型标注自动生成输入模式（inputSchema）。
代码推送到连接的仓库后，Appwrite 自动构建并激活新版本。
由于运行在项目内，工具可以利用请求自带的动态 API 密钥，直接安全地访问你的 Appwrite 数据库、存储等，无需额外凭证轮换。
无状态时代的天然适配：
MCP 2026-07-28 规范将协议核心改为无状态，每个请求自成一体，不再依赖粘性会话，这让 Appwrite Functions 这种请求/响应式平台成为托管 MCP 服务器的理想环境。模板同时支持新旧两种协议路径。
适用场景：
构建内部团队工具（查订单、产品信息、触发工作流等）。
对外部 API 做受控封装，只暴露少数必要操作并加入自定义校验。
创建直接操作 Appwrite 数据的工具。
明确限制：
不支持流式传输：没有 SSE，工具只能返回最终结果，不能推送进度，服务器也无法向客户端发起采样请求。
不支持长时间调用：函数同步执行上限 30 秒，建议工具超时设为 25 秒。若需长时间运行，应拆分为启动 + 轮询两个工具，或改用容器化方案。
如果你想用 AI 直接管理 Appwrite 本身，可以使用已有的托管 Appwrite MCP 服务器，无需自己构建。该模板现已上线 Appwrite Cloud 及自托管实例。
https://appwrite.io/blog/post/announcing-mcp-server-template