Kiro IDE的Appwrite功能
使用Appwrite构建后端服务的全面Kiro功能，包括数据库、身份验证、存储、功能以及web和移动应用程序的消息传递。
现在使用MCP Server 2.0！ 零配置、自动服务发现和最小的上下文使用。
   
🚀 快速开始
安装
- 打开Kiro IDE
- 转到电源面板 → 从GitHub添加电源
- 输入存储库URL:
https://github.com/iamaanahmad/appwrite-power - 安装电源
或者从本地路径安装：
- 克隆此存储库
- 打开Kiro IDE→ 电源面板→ 从本地路径添加电源
- 选择克隆的目录
先决条件
对于API服务器：
- 紫外线 -Python包管理器（0.4.1+版本）
- 具有API密钥的Appwrite项目
对于文档服务器：
- 无需先决条件（基于HTTP）
配置
- 创建Appwrite项目 在 cloud.apwrite.io
- 获取您的凭据:
- 项目ID（来自“设置”页面） - API密钥（来自设置→ API密钥） - 端点URL（例如。， https://nyc.cloud.appwrite.io/v1)
- 设置环境变量:
Windows（PowerShell）：
$env:APPWRITE_PROJECT_ID="your-project-id"
$env:APPWRITE_API_KEY="your-api-key"
$env:APPWRITE_ENDPOINT="https://nyc.cloud.appwrite.io/v1"macOS/Linux：
export APPWRITE_PROJECT_ID="your-project-id"
export APPWRITE_API_KEY="your-api-key"
export APPWRITE_ENDPOINT="https://nyc.cloud.appwrite.io/v1"或者将它们添加到MCP配置文件中。
📚 包含内容
MCP服务器2.0架构
革命性的双工具设计：
- 只有两个工具暴露在模型中：
appwrite_search_tools和appwrite_call_tool - 完整的Appwrite目录保留在内部，并在运行时进行搜索
- 最小化上下文使用-为代码提供更多空间
- 零配置-不需要服务标志
- 自动服务发现-默认情况下所有API都可用
双MCP服务器
1.Appwrite API服务器（版本0.4.1+）
通过基于Python的MCP服务器与Appwrite服务直接交互。
2.0版本的新增功能：
- ✅ 不再有服务标志 -删除
--users,--storage,--functions等等。 - ✅ 所有服务均已启用 -数据库、用户、存储、功能、消息传递、站点、团队
- ✅ 紧凑的架构 -只有2个MCP工具，而不是几十个
- ✅ 智能搜索 -AI基于自然语言找到合适的工具
- ✅ 启动验证 -服务器启动时检查凭据
从v1.x迁移：
// OLD (v1.x) - Don't use this anymore
{
"args": ["mcp-server-appwrite", "--users", "--storage", "--functions"]
}
// NEW (v2.0) - Use this instead
{
"args": ["mcp-server-appwrite"]
}2.Appwrite文档服务器
查询Appwrite文档以获取指导、API参考和代码示例。
服务覆盖范围
- 数据库：集合、文档、查询、索引、交易
- 认证：用户管理、会话、OAuth、MFA
- 存储：Bucket、文件操作、图像转换
- 函数：无服务器部署，多个运行时
- 消息传递：电子邮件、短信、推送通知
- 站点：静态站点、SSR应用程序
- 团队：团队管理、成员资格、角色
🎯 特性
MCP服务器2.0的优点
- 零配置：不需要服务标志-一切都会自动工作
- 最小上下文：双工具架构使用的上下文比v1.x少
- 自然语言：使用会话查询搜索工具
- 所有服务：数据库、用户、存储、功能、消息传递、站点、团队-所有可用
- 智能发现：AI会自动为您的任务找到合适的工具
- 启动验证：服务器启动时验证凭据，而不是在第一次调用时验证凭据
自动激活
当你提到这些关键字时，电源就会激活：
- appwrite、后端、数据库
- 身份验证、身份验证、存储
- 函数、无服务器、baas
- api、用户、团队、消息传递
综合文档
- 逐步入职
- MCP 2.0迁移指南
- 自然语言使用示例
- 完整的工作流程
- 最佳实践指南
- 故障排除提示
📖 使用示例
自然语言查询（MCP 2.0）
// Just ask in natural language - AI handles the rest!
"Create a database called 'production'"
// AI searches for and calls: databases_create
"Add a user with email john@example.com"
// AI searches for and calls: users_create
"Upload avatar.jpg to the avatars bucket"
// AI searches for and calls: storage_create_file
"List all users in my project"
// AI searches for and calls: users_list
"Deploy my function code"
// AI searches for and calls: functions_create_deployment传统的API调用（仍然支持）
// Search for the right tool
appwrite_search_tools({
"query": "create a new database"
})
// Call the tool
appwrite_call_tool({
"tool_name": "databases_create",
"arguments": {
"database_id": "main",
"name": "Main Database",
"enabled": true
}
})📁 仓库结构
appwrite-power/
├── POWER.md # Main power documentation
├── mcp.json # MCP server configuration
├── steering/
│ └── steering.md # Best practices guide
├── README.md # This file
└── LICENSE # BSD-3-Clause license🔧 配置
最低配置（MCP服务器2.0）
{
"mcpServers": {
"appwrite-api": {
"command": "uvx",
"args": ["mcp-server-appwrite"],
"env": {
"APPWRITE_PROJECT_ID": "${APPWRITE_PROJECT_ID}",
"APPWRITE_API_KEY": "${APPWRITE_API_KEY}",
"APPWRITE_ENDPOINT": "${APPWRITE_ENDPOINT}"
}
}
}
}完整配置（API+文档）
{
"mcpServers": {
"appwrite-api": {
"command": "uvx",
"args": ["mcp-server-appwrite"],
"env": {
"APPWRITE_PROJECT_ID": "${APPWRITE_PROJECT_ID}",
"APPWRITE_API_KEY": "${APPWRITE_API_KEY}",
"APPWRITE_ENDPOINT": "${APPWRITE_ENDPOINT}"
}
},
"appwrite-docs": {
"url": "https://mcp-for-docs.appwrite.io",
"type": "http"
}
}
}重要提示： 如果从v1.x升级， 删除所有服务标志 (--users, --storage, --functions等等）。他们不再需要或支持。
📚 文档
- 功率.md：完整的电源文档，包括示例和工作流程
- 转向/转向.md：生产应用的最佳实践
- Appwrite文档
- 基洛力量指南
🛠️ 故障排除
“API密钥无效”
- 验证Appwrite控制台中的API密钥
- 检查环境变量是否已设置
- 确保API密钥具有所需的作用域
“找不到数据库”
- 验证数据库ID是否正确
- 检查数据库是否已启用
- 如果数据库不存在，则创建数据库
“权限被拒绝”
- 检查文档/收集权限
- 验证用户是否经过身份验证
- 更新权限以授予访问权限
有关更多故障排除提示，请参阅 功率.md.
🤝 贡献
欢迎投稿！请随时提交问题或拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📝 最佳实践
- 使用自然语言 -MCP 2.0理解会话查询
- 所有可用服务 -无需配置特定服务
- 使用文档级权限 用于细粒度访问控制
- 创建索引 用于频繁查询的属性
- 启用文档安全 关于敏感数据的收集
- 使用交易记录 用于原子多文档操作
- 存储敏感数据 环境变量
- 沙盒测试 生产部署前
- 从v1.x升级 -从配置中删除所有服务标志
看 转向/转向.md 以获取全面的最佳实践。
🔗 链接
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- Appwrite团队 令人惊叹的后端平台和MCP Server 2.0
- Kiro IDE团队 强大的开发环境
- MCP（模型上下文协议）用于实现无缝集成
💬 支持
- 问题:
- 讨论:
- Appwrite不一致: 加入社区
______________________________________________________________________
制作❤️ Kiro和Appwrite社区