Kotlin MCP Server

🚀 企业级Kotlin Android MCP服务器

这是一个全面的模型上下文协议（MCP）服务器，为AI智能体提供企业级访问基于Kotlin的Android开发项目的能力。该服务器能够提供上下文感知的协助，并具备高级安全、隐私合规、AI集成和全面的开发工具。

---

📋 修订历史

版本2.1 (当前 - 2025年8月)

增强版发布：统一智能服务器

🎯 最新改进

• 🧠 智能工具管理：所有27个工具现在都使用具有类似LSP功能的智能代理系统。
• 🔄 服务器整合：统一为单个kotlin_mcp_server.py文件，架构得到增强。
• 📁 简洁架构：归档冗余的服务器版本，使项目结构更清晰。
• ⚡ 增强工具暴露：完整的工具套件通过智能管理系统正确暴露。
• 🛠️ 改进工具路由：在原生实现和智能代理之间实现智能委托。

🔧 架构变更

• 统一服务器：单个kotlin_mcp_server.py文件取代了多个服务器版本。
• 智能代理系统：未完全实现的工具使用带有AI增强的智能代理。
• 简洁文件结构：旧版服务器归档在archive/legacy-servers/目录中。
• 增强工具管理器：与IntelligentMCPToolManager集成，具备高级功能。
• 完整工具覆盖：所有32个工具都正确暴露并可正常使用。

📊 工具实现状态

• 完全实现：6个工具（format_code、run_lint、generate_docs、create_compose_component、setup_mvvm_architecture、security_hardening）
• 旧版集成：3个核心工具（create_kotlin_file、gradle_build、analyze_project）
• 智能代理：23个工具具有智能回退实现。
• 可用总数：32个工具，全面覆盖Android开发。

版本2.0 (2025年8月)

重大版本发布：AI增强的模块化架构

🎯 关键改进

• 🤖 AI集成：从模板生成器转变为AI驱动的开发助手。
• 🏗️ 模块化架构：将单体结构重构为6个专门的模块。
• 🌍 动态配置：消除所有硬编码路径，实现跨平台可移植性。
• ⚡ 增强工具：工具数量从30个扩展到31个，并具有AI增强实现。
• 🛡️ 安全强化：添加可配置的审计跟踪和合规监控。
• 📦 零配置设置：智能安装程序可自动检测环境。

🔧 技术变更

• 模块化设计：拆分为ai/、android/、gradle/、security/、testing/、utils/模块。
• AI驱动的代码生成：利用调用大语言模型生成可投入生产的代码（无TODO）。
• 环境变量支持：所有配置现在都使用动态环境变量。
• 跨平台路径：通用的~符号取代特定于操作系统的硬编码路径。
• 增强错误处理：全面验证和优雅的故障恢复。
• 性能优化：通过更好的资源管理简化工具执行。

📊 迁移影响

• 工具：从30个增加到32个工具（功能等效性达到107%并有所增强）。
• 文件大小：优化的模块化结构与单体方法相比更优。
• 配置：无需手动配置路径。
• 兼容性：与现有设置保持完全向后兼容。

版本1.0 (旧版 - 2025年8月之前)

初始版本发布：基于模板的代码生成器

• ✅ 带有30个工具的基本MCP服务器
• ✅ 基于模板的Kotlin/Android代码生成
• ✅ 手动配置，使用硬编码路径
• ✅ 单体架构
• ✅ 基本的安全和合规功能

---

🌟 企业级特性概述

🔒 安全与隐私合规

• GDPR合规 - 完整实现，包括同意管理、数据可移植性、删除权。
• HIPAA合规 - 医疗级安全，包括审计日志、访问控制、加密。
• 数据加密 - 使用AES - 256加密和PBKDF2密钥派生对敏感数据进行加密。
• 审计跟踪 - 全面的日志记录，带有合规标志和安全事件跟踪。
• 隐私设计 - 所有操作都内置隐私保护。

🤖 AI/ML集成

• 本地大语言模型支持 - 支持Ollama、LocalAI和自托管的变换器。
• 外部大语言模型API - 支持OpenAI GPT - 4、Anthropic Claude和自定义端点。
• AI驱动的代码分析 - 进行安全、性能和复杂性分析。
• 智能代码生成 - 上下文感知的Kotlin/Android代码创建。
• ML模型集成 - 为Android应用集成TensorFlow Lite、ONNX、PyTorch Mobile。

📁 高级文件管理

• 企业级文件操作 - 备份、恢复、同步、加密、解密，并带有审计跟踪。
• 实时同步 - 使用文件系统监视器实现自动同步。
• 云存储集成 - 与AWS S3、Google Cloud、Azure集成，提供端到端加密。
• 智能文件分类 - 自动检测和加密敏感数据。
• 版本控制 - 支持Git操作，具备冲突解决功能。

🌐 外部API集成

• 全面的认证支持 - 支持API密钥、OAuth 2.0、JWT、基本认证。
• 安全特性 - 速率限制、请求日志记录、响应验证。
• 实时监控 - 监控API使用指标、性能跟踪、成本分析。
• 合规验证 - 符合GDPR/HIPAA的API处理。

🏗️ 高级Android开发

• 架构模式 - MVVM、简洁架构、依赖注入。
• 现代UI开发 - Jetpack Compose、自定义视图、复杂布局。
• 数据库集成 - 集成Room并支持加密和迁移处理。
• 网络层 - 支持Retrofit、GraphQL、WebSocket。
• 测试框架 - 全面的测试生成和执行。

---

🚀 快速开始与安装

✨ 升级到V2.0的亮点

🤖 AI增强开发：现在利用AI助手生成可投入生产的代码，而不是基本模板！

升级前 (V1.0)：

• ❌ 基于模板的代码，带有TODO占位符。
• ❌ 在配置文件中手动编辑路径。
• ❌ 单体架构（单个大文件）。
• ❌ 硬编码路径和特定于用户的配置。
• ❌ 30个基本工具，AI集成有限。

升级后 (V2.0)：

• ✅ AI驱动的代码生成：完整的、上下文感知的实现。
• ✅ 零配置设置：python3 install.py命令可处理所有配置。
• ✅ 模块化架构：简洁、可维护的6模块结构。
• ✅ 动态配置：跨平台，使用环境变量。
• ✅ 31个增强工具：集成AI，具备智能错误处理。

📋 系统要求

• Python 3.8+（推荐3.9+）
• pip（Python包管理器）
• Git（用于克隆仓库）
• 支持MCP的IDE（VS Code、JetBrains IDE、Claude Desktop）

🔧 安装步骤

1. 克隆仓库

git clone <your-repo-url>
cd kotlin-mcp-server

2. 自动化安装与配置

项目包含一个增强的安装脚本，可自动处理所有配置：

# 交互式安装（推荐首次使用的用户）
python3 install.py

# 非交互式安装，使用特定配置
python3 install.py [install_type] [project_path] [server_name] [use_env_vars]

# 显示所有可用选项
python3 install.py --help

安装类型：

• 1 - 便携版：直接从项目目录运行。
• 2 - 系统版：将命令安装到PATH中（kotlin-android-mcp）。
• 3 - 模块版：启用python -m kotlin_mcp_server。

配置示例：

# 交互式设置（询问您的偏好）
python3 install.py 1

# 便携版，指定您的Android项目路径（替换为实际路径）
python3 install.py 1 ~/AndroidStudioProjects/MyApp

# 系统安装，使用动态环境变量
python3 install.py 2 none my-android-server true

# 模块安装，使用自定义服务器名称
python3 install.py 3 /path/to/project kotlin-dev false

安装程序的功能：

• ✅ 安装所有Python依赖项：从requirements.txt文件中安装。
• ✅ 创建特定于平台的配置文件：（Claude、VS Code、通用）
• ✅ 设置正确的文件权限：为脚本设置权限。
• ✅ 配置环境变量：根据您的选择进行配置。
• ✅ 消除手动路径更新：在配置文件中无需手动更新路径。
• ✅ 提供清晰的集成说明：为您的设置提供准确的集成步骤。

3. 手动安装（可选）

如果您更喜欢手动安装：

# 安装核心依赖项
pip install -r requirements.txt

# 可选：安装AI/ML依赖项以使用高级功能
pip install openai anthropic transformers torch

# 验证安装
python3 -c "import kotlin_mcp_server; print('✅ 安装成功')"

已安装的关键依赖项：

• 核心MCP：python-dotenv、pydantic
• 安全：cryptography、bcrypt、PyJWT
• 数据库：aiosqlite、sqlalchemy
• HTTP客户端：aiohttp、httpx
• 文件管理：aiofiles、watchdog
• 测试：pytest、pytest-asyncio、coverage
• 代码质量：black、flake8、pylint、mypy
• 安全工具：bandit、safety

4. V2.0架构与工具增强

🏗️ 模块化架构设计

V2.0版本引入了简洁、可维护的模块化结构：

kotlin-mcp-server/
├── kotlin_mcp_server.py      # 主服务器（32个AI增强工具）
├── ai/
│   ├── llm_integration.py    # AI助手集成
│   └── code_enhancement.py   # AI驱动的代码生成
├── android/
│   ├── project_manager.py    # 项目结构管理  
│   └── manifest_utils.py     # Android清单操作
├── gradle/
│   ├── build_system.py       # Gradle构建自动化
│   └── dependency_manager.py # 依赖解析
├── security/
│   ├── compliance.py         # GDPR/HIPAA合规
│   └── encryption.py         # 数据保护
├── testing/
│   └── test_generator.py     # 自动化测试创建
└── utils/
    ├── file_operations.py    # 增强文件管理
    └── security.py           # 审计跟踪和日志记录

🤖 AI增强工具能力

工具类别	V1.0（模板）	V2.0（AI增强）
代码生成	带有TODO的基本模板	可投入生产的、上下文感知的实现
架构模式	骨架代码	完整的MVVM、简洁架构模式
UI组件	静态布局	带有业务逻辑的动态Jetpack Compose
数据库操作	模式模板	带有迁移的完整Room实现
测试	测试存根	包含边缘情况的全面测试套件
安全	基本验证	具备合规性的企业级安全

⚡ 性能与可靠性改进

• 31个工具（V1.0版本为30个），AI集成增强。
• 错误恢复：优雅处理AI服务中断。
• 上下文感知：工具能够理解项目结构和需求。
• 资源优化：高效的内存使用和更快的执行速度。
• 跨平台支持：通用配置系统。

5. IDE集成设置

安装完成后，脚本会生成可直接使用的配置文件：

• mcp_config_claude.json - 用于Claude Desktop。
• mcp_config_vscode.json - 用于VS Code和Cursor。
• mcp_config.json - 用于其他MCP客户端。

集成说明：

🔹 Claude Desktop：将mcp_config_claude.json的内容复制到：

• Mac：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/claude/claude_desktop_config.json

🔹 VS Code/Cursor：添加到您的VS Code settings.json中：

{
  "mcp.server.configFiles": [
    "/absolute/path/to/mcp_config_vscode.json"
  ]
}

🔹 其他IDE：使用mcp_config.json与您的MCP客户端集成。

5. 环境配置（高级）

对于需要自定义环境设置的高级用户： 在项目根目录下创建一个.env文件（仅在高级配置时需要）：

# 复制示例文件并进行自定义
cp .env.example .env

# 使用您喜欢的编辑器进行编辑
nano .env  # 或使用其他编辑器

可选变量：

# 安全（生成强密码）
MCP_ENCRYPTION_PASSWORD=$(openssl rand -base64 32)
COMPLIANCE_MODE=gdpr,hipaa

# 可选：AI集成
OPENAI_API_KEY=your-openai-api-key-here
ANTHROPIC_API_KEY=your-anthropic-api-key-here

💡 注意：安装脚本会自动配置项目路径和服务器设置，因此手动环境配置仅在需要高级功能（如AI集成或自定义安全设置）时才需要。

6. 安装所需的IDE扩展/插件

请参阅下面的插件要求部分，了解特定于IDE的扩展。

7. 测试安装

# 使用您配置的设置测试服务器
# 如果您在安装过程中使用了固定的项目路径：
python3 kotlin_mcp_server.py

# 如果您使用的是动态/环境变量：
python3 kotlin_mcp_server.py /path/to/android/project

# 对于系统安装：
kotlin-android-mcp

# 对于模块安装：
python3 -m kotlin_mcp_server

# 验证配置（可选）
python3 validate_config.py

# 运行全面测试（可选）
python test_mcp_comprehensive.py

# 测试VS Code桥接服务器（可选）
python3 vscode_bridge.py &
sleep 2
curl http://localhost:8080/health
# 应返回：{"status": "healthy", ...}
kill %1  # 停止后台桥接服务器

⚡ 快速设置命令

# 一键完成设置（交互式）
python3 install.py

# 为开发环境快速设置
make setup-dev

# 快速验证
make dev-check

# 完整质量管道
make ci

# 测试VS Code桥接服务器（可选）
python3 vscode_bridge.py --test-mode

🎯 安装总结

增强的安装过程消除了手动配置的需要：

✅ 之前（手动）：用户必须手动编辑配置文件、查找路径、更新环境变量。 ✅ 之后（自动化）：一个命令即可创建所有可直接使用的配置。

关键改进：

• 🚀 零手动配置：无需再更新路径或编辑变量。
• 🎛️ 交互式和非交互式：适用于所有用户的两种模式。
• 🔧 特定于平台的配置：为每个IDE/客户端生成优化的文件。
• 📋 清晰的说明：为您的设置提供准确的集成步骤。
• ✨ 智能默认值：智能处理环境变量。

🐳 Docker部署（可选）

对于容器化部署，项目提供了全面的Docker支持：

快速Docker设置

# 1. 验证Docker配置
python3 validate_docker.py

# 2. 使用设置脚本构建并运行
./docker-setup.sh build
./docker-setup.sh start

# 3. 或者直接使用Docker Compose
docker-compose up -d kotlin-mcp-server

Docker特性

• 🔒 安全：使用非root用户，最小化攻击面。
• 📦 优化：多阶段构建，层缓存。
• 🔍 健康检查：自动监控容器健康状况。
• 🛠️ 开发：支持卷挂载，便于实时开发。
• 🚀 生产：支持守护模式，用于生产部署。

可用命令

./docker-setup.sh build              # 构建镜像
./docker-setup.sh start              # 交互式开发
./docker-setup.sh daemon [path]      # 生产守护模式
./docker-setup.sh logs               # 查看容器日志
./docker-setup.sh shell              # 打开容器shell
./docker-setup.sh test               # 在容器中运行测试
./docker-setup.sh clean              # 清理资源

有关详细的Docker设置说明，请参阅DOCKER_SETUP.md

---

🎯 实战验证：生成真实的Android应用

准备好见证系统生成完整的、可投入生产的Android应用了吗？ 按照以下步骤，体验完整的端到端工作流程：

🚀 快速开始：生成您的第一个应用

# 1. 构建Kotlin边车（创建胖JAR）
make sidecar

# 2. 生成具有所有功能的完整Android应用
make e2e

# 3. 您的APK文件将出现在这里：
ls -la e2e/sampleapp/app/build/outputs/apk/debug/app-debug.apk

您将获得：

• ✅ 完整的Gradle项目（Kotlin、Compose、Hilt、MVVM）
• ✅ 可运行的Android应用，包含主屏幕和详情屏幕。
• ✅ Room数据库，包含实体和DAO。
• ✅ Retrofit网络层，包含API服务。
• ✅ 单元测试通过（Robolectric + JVM测试）
• ✅ 可在设备/模拟器上安装的APK

🔧 可用命令

# 构建Kotlin边车JAR
make sidecar

# 生成完整的Android应用
make e2e

# 格式化和优化代码
make fix

# 运行detekt静态分析
make detekt

# 运行spotless代码格式化检查
make spotless

# 清理所有工件
make clean

📊 生成应用的特性

生成的e2e/sampleapp应用包含：

🏗️ 架构：

• MVVM模式，使用ViewModel。
• Hilt依赖注入。
• 遵循简洁架构原则。

🎨 UI/UX：

• Jetpack Compose屏幕。
• Material3设计。
• 屏幕间导航。

💾 数据层：

• Room数据库，包含实体。
• 存储库模式。
• 迁移骨架。

🌐 网络：

• Retrofit API客户端。
• OkHttp拦截器。
• 错误处理。

🧪 测试：

• ViewModel的单元测试。
• 使用Robolectric进行DAO测试。
• API服务测试。

📱 构建：

• 生成调试APK。
• 进行Lint/格式化检查。
• 优化Gradle构建。

⚙️ 环境变量

# 边车配置
MCP_SIDECAR_CMD=["java", "-jar", "kotlin-sidecar/build/libs/kotlin-sidecar.jar"]

# 性能调优
MCP_API_TIMEOUT_MS=3000
MCP_RATE_LIMIT_QPS=10

# 构建设置
ANDROID_SDK_ROOT=/path/to/android/sdk
JAVA_HOME=/path/to/jdk17

🔍 故障排除

Gradle构建失败：

# 确保安装了Android SDK并设置了ANDROID_SDK_ROOT
export ANDROID_SDK_ROOT=/path/to/android/sdk

# 清理并重新构建
make clean && make e2e

边车连接问题：

# 检查JAR文件是否已构建
ls -la kotlin-sidecar/build/libs/kotlin-sidecar.jar

# 直接测试边车
java -jar kotlin-sidecar/build/libs/kotlin-sidecar.jar

APK未生成：

# 检查构建日志
cd e2e/sampleapp && ./gradlew assembleDebug --info

# 确保使用的是JDK 17
java -version  # 应显示Java 17

📈 性能基准

系统针对以下方面进行了优化：

• 边车启动：< 2秒
• 代码生成：每个组件< 5秒
• 构建时间：调试APK< 30秒
• 测试执行：单元测试< 10秒

🎉 成功指标

当一切正常时：

• ✅ kotlin-sidecar.jar成功构建。
• ✅ e2e/sampleapp目录创建，包含完整项目。
• ✅ ./gradlew assembleDebug无错误完成。
• ✅ APK文件存在：app/build/outputs/apk/debug/app-debug.apk。
• ✅ ./gradlew testDebugUnitTest测试通过。
• ✅ 生成的代码中没有TODO占位符。
• ✅ 所有Lint/格式化检查通过。

🎯 生成的应用可投入生产，可立即在Android Studio中打开！

---

🏥 从V1.0迁移到V2.0

⚡ 快速迁移步骤

如果您已经安装了V1.0版本：

1. 备份当前设置：

   # 备份您现有的配置
   cp mcp_config*.json ~/backup/
   

2. 更新到V2.0：

   # 拉取最新更改
   git pull origin main
   
   # 运行V2.0安装程序
   python3 install.py 1
   

3. 验证迁移：

   # 测试新的模块化架构
   python3 -c "from kotlin_mcp_server import KotlinMCPServer; print('✅ V2.0就绪！')"
   

🔍 自动迁移的内容

• ✅ 所有30个原始工具：保留并增强了AI功能。
• ✅ 配置文件：使用动态环境变量进行更新。
• ✅ 项目路径：转换为跨平台格式。
• ✅ 依赖项：更新到最新版本。
• ✅ 安全设置：增强了新的合规功能。

⚠️ 迁移注意事项

• 向后兼容性：V2.0与V1.0项目结构保持完全兼容。
• 增强输出：代码生成现在生成完整的实现，而不是模板。
• 新环境变量：可选的新配置选项（请参阅.env.example）。
• 模块化结构：内部架构得到改进（无需用户操作）。

---

🏗️ 项目根目录解析策略

概述

Kotlin MCP服务器中的所有工具都经过重构，仅在用户的项目工作区中运行，而不会在MCP服务器的当前工作目录中运行。这确保了工具行为的安全性和可预测性，防止意外修改项目外的文件。

路径解析优先级

工具按以下顺序解析项目根目录：

1. 显式输入：project_root或projectRoot参数。
2. 环境变量：PROJECT_PATH或WORKSPACE_PATH。
3. IDE元数据：从MCP客户端（VS Code、Cursor等）获取的工作区根目录。
4. 故障安全：工具将报错，而不会使用服务器的当前工作目录。

输入同义词

工具接受驼峰命名法和蛇形命名法的参数名称：

// 两种格式的效果相同
{
  "project_root": "/path/to/project",
  "file_path": "src/main.kt",
  "build_tool": "gradle",
  "skip_tests": false
}

{
  "projectRoot": "/path/to/project", 
  "filePath": "src/main.kt",
  "buildTool": "gradle",
  "skipTests": false
}

IDE集成默认值

使用IDE扩展（VS Code、Cursor）时，工具会自动检测：

• 工作区根目录：活动工作区目录。
• 活动文件：当前打开的文件，用于基于文件的操作。
• 选择内容：文本选择，用于重构操作。

安全保障

• 路径遍历保护：所有文件路径都经过验证，确保在项目根目录下。
• 服务器当前工作目录保护：运行时检查，防止意外操作服务器目录。
• 审计日志：所有工具操作都记录项目上下文。

工具调用示例

显式指定项目根目录：

{
  "tool": "buildAndTest",
  "input": {
    "project_root": "/Users/dev/MyAndroidApp",
    "buildTool": "gradle",
    "skipTests": false
  }
}

使用环境变量：

export PROJECT_PATH=/Users/dev/MyAndroidApp
# 不指定project_root的工具调用将使用环境变量

IDE自动检测：

{
  "tool": "analyzeCodeQuality",
  "input": {
    "scope": "project",
    "ruleset": "all"
  }
}
// 自动使用活动工作区

错误处理

当无法解析项目根目录时，工具会提供清晰的错误信息：

{
  "success": false,
  "error": "ProjectRootRequired: pass `project_root` or set env PROJECT_PATH",
  "error_type": "ProjectRootRequired"
}

---

📚 全面使用指南

🛠 完整工具参考

Kotlin MCP服务器为Android开发提供了31个全面的工具，按类别组织：

核心开发工具

1. gradle_build - 构建Android项目

执行Gradle构建任务，用于您的Android项目。

{
  "name": "gradle_build",
  "arguments": {
    "task": "assembleDebug",
    "clean_build": false,
    "parallel": true
  }
}

参数：

• task（字符串）：要执行的Gradle任务（例如，"assembleDebug"、"build"、"test"）
• clean_build（布尔值，可选）：是否在构建前清理。
• parallel（布尔值，可选）：是否启用并行执行。

使用示例：

# 构建调试APK
{"name": "gradle_build", "arguments": {"task": "assembleDebug"}}

# 清理并构建发布版
{"name": "gradle_build", "arguments": {"task": "assembleRelease", "clean_build": true}}

# 运行所有测试
{"name": "gradle_build", "arguments": {"task": "test"}}

2. run_tests - 执行测试套件

运行单元测试、集成测试或UI测试，并提供全面的报告。

{
  "name": "run_tests",
  "arguments": {
    "test_type": "unit",
    "test_class": "UserRepositoryTest",
    "generate_report": true
  }
}

参数：

• test_type（字符串）："unit"、"integration"、"ui"或"all"
• test_class（字符串，可选）：要运行的特定测试类。
• generate_report（布尔值，可选）：是否生成HTML测试报告。

3. create_kotlin_file - 生成Kotlin文件

创建具有正确包声明和导入的结构化Kotlin文件。

{
  "name": "create_kotlin_file",
  "arguments": {
    "file_path": "src/main/kotlin/com/example/User.kt",
    "class_name": "User",
    "class_type": "data_class",
    "properties": ["id: String", "name: String", "email: String"],
    "package_name": "com.example.model"
  }
}

参数：

• file_path（字符串）：新文件的相对路径。
• class_name（字符串）：主类的名称。
• class_type（字符串）："class"、"data_class"、"sealed_class"、"object"、"interface"
• properties（数组，可选）：数据类的属性列表。
• package_name（字符串，可选）：包声明。

4. create_layout_file - 生成XML布局

创建具有正确结构的Android XML布局文件。

{
  "name": "create_layout_file",
  "arguments": {
    "file_path": "src/main/res/layout/activity_main.xml",
    "layout_type": "activity",
    "root_element": "LinearLayout",
    "include_common_attributes": true
  }
}

5. analyze_project - 项目分析

对您的Android项目结构、依赖项和架构进行全面分析。

{
  "name": "analyze_project",
  "arguments": {
    "analysis_type": "architecture",
    "include_dependencies": true,
    "check_best_practices": true
  }
}

分析类型：

• architecture：整体项目结构和模式。
• dependencies：Gradle依赖项和版本。
• security：安全漏洞和最佳实践。
• performance：性能瓶颈和优化建议。

6. format_code - 代码格式化

根据风格指南格式化Kotlin代码。

{
  "name": "format_code",
  "arguments": {
    "file_path": "src/main/kotlin/MainActivity.kt",
    "style_guide": "ktlint"
  }
}

7. run_lint - 静态代码分析

运行Lint分析，检测代码问题。

{
  "name": "run_lint",
  "arguments": {
    "lint_tool": "detekt",
    "fail_on_warnings": false,
    "generate_report": true
  }
}

8. generate_docs - 文档生成

以各种格式生成项目文档。

{
  "name": "generate_docs",
  "arguments": {
    "doc_type": "kdoc",
    "output_format": "html",
    "include_private": false
  }
}

UI开发工具

9. create_compose_component - Jetpack Compose组件

生成遵循最佳实践的Jetpack Compose UI组件。

{
  "name": "create_compose_component",
  "arguments": {
    "component_name": "UserCard",
    "component_type": "composable",
    "file_path": "src/main/kotlin/ui/components/UserCard.kt",
    "parameters": [
      "user: User",
      "onClick: () -> Unit"
    ],
    "include_preview": true,
    "material_design": "material3"
  }
}

组件类型：

• composable：标准可组合函数。
• stateful：带有内部状态的可组合函数。
• stateless：纯UI可组合函数。
• layout：带有子组件的布局可组合函数。

10. create_custom_view - 自定义Android视图

创建具有正确生命周期管理的自定义视图类。

{
  "name": "create_custom_view",
  "arguments": {
    "view_name": "CircularProgressView",
    "base_class": "View",
    "file_path": "src/main/kotlin/ui/views/CircularProgressView.kt",
    "custom_attributes": [
      {"name": "progressColor", "type": "color"},
      {"name": "strokeWidth", "type": "dimension"}
    ]
  }
}

架构与模式工具

11. setup_mvvm_architecture - MVVM实现

设置完整的MVVM架构，包括ViewModel、存储库和UI层。

{
  "name": "setup_mvvm_architecture",
  "arguments": {
    "feature_name": "UserProfile",
    "package_name": "com.example.userprofile",
    "include_repository": true,
    "include_use_cases": true,
    "state_management": "compose"
  }
}

生成的文件：

• 带有状态管理的ViewModel。
• 带有数据源抽象的存储库。
• 用于业务逻辑的用例。
• UI可组合函数或片段。
• 用于事件的状态类和密封类。

12. setup_dependency_injection - 依赖注入框架设置

使用Hilt或Dagger配置依赖注入。

{
  "name": "setup_dependency_injection",
  "arguments": {
    "di_framework": "hilt",
    "modules": ["DatabaseModule", "NetworkModule", "RepositoryModule"],
    "application_class": "MyApplication"
  }
}

13. setup_room_database - 数据库设置

创建Room数据库实现，包括实体、DAO和迁移。

{
  "name": "setup_room_database",
  "arguments": {
    "database_name": "AppDatabase",
    "entities": [
      {
        "name": "User",
        "fields": [
          {"name": "id", "type": "String", "primaryKey": true},
          {"name": "name", "type": "String"},
          {"name": "email", "type": "String"}
        ]
      }
    ],
    "version": 1,
    "enable_encryption": true
  }
}

14. setup_retrofit_api - 网络层

设置Retrofit API接口，包括正确的错误处理和拦截器。

{
  "name": "setup_retrofit_api",
  "arguments": {
    "base_url": "https://api.example.com/",
    "endpoints": [
      {
        "name": "getUser",
        "method": "GET",
        "path": "users/{id}",
        "response_type": "User"
      }
    ],
    "include_interceptors": ["logging", "auth", "retry"],
    "enable_cache": true
  }
}

安全与合规工具

15. encrypt_sensitive_data - 数据加密

使用行业标准的加密算法加密敏感数据。

{
  "name": "encrypt_sensitive_data",
  "arguments": {
    "data": "患者: 约翰· Doe，社保号: 123 - 45 - 6789",
    "data_type": "phi",
    "compliance_level": "hipaa",
    "encryption_algorithm": "AES - 256"
  }
}

16. implement_gdpr_compliance - GDPR实现

实现完整的GDPR合规框架。

{
  "name": "implement_gdpr_compliance",
  "arguments": {
    "package_name": "com.example.app",
    "features": [
      "consent_management",
      "data_portability",
      "right_to_erasure",
      "privacy_policy",
      "data_breach_notification"
    ],
    "supported_languages": ["en", "de", "fr"],
    "include_ui": true
  }
}

生成的组件：

• 同意管理UI和逻辑。
• 数据导出功能。
• 用户数据删除工作流。
• 隐私政策模板。
• 审计日志系统。

17. implement_hipaa_compliance - HIPAA实现

实现符合HIPAA的安全措施。

{
  "name": "implement_hipaa_compliance",
  "arguments": {
    "package_name": "com.healthcare.app",
    "features": [
      "audit_logging",
      "access_controls",
      "encryption",
      "secure_messaging",
      "risk_assessment"
    ],
    "minimum_password_strength": "high",
    "session_timeout": 900
  }
}

18. setup_secure_storage - 安全数据存储

配置用于敏感数据的加密存储。

{
  "name": "setup_secure_storage",
  "arguments": {
    "storage_type": "room_encrypted",
    "package_name": "com.example.app",
    "data_classification": "restricted",
    "key_management": "android_keystore"
  }
}

AI/ML集成工具

19. query_llm - 大语言模型查询

查询本地或远程大语言模型，获取代码帮助。

{
  "name": "query_llm",
  "arguments": {
    "prompt": "生成一个带有验证的Kotlin数据类User",
    "llm_provider": "local",
    "model": "codellama",
    "privacy_mode": true,
    "max_tokens": 1000,
    "temperature": 0.2
  }
}

支持的提供商：

• local：Ollama、LocalAI。
• openai：GPT - 4、GPT - 3.5。
• anthropic：Claude模型。
• custom：自定义API端点。

20. analyze_code_with_ai - AI代码分析

使用AI分析代码的各个方面。

{
  "name": "analyze_code_with_ai",
  "arguments": {
    "file_path": "src/main/kotlin/UserManager.kt",
    "analysis_type": "security",
    "use_local_model": true,
    "detailed_report": true
  }
}

分析类型：

• security：安全漏洞和最佳实践。
• performance：性能优化建议。
• bugs：潜在的bug检测。
• style：代码风格改进。
• complexity：代码复杂性分析。
• maintainability：可维护性评估。

21. generate_code_with_ai - AI代码生成

根据自然语言描述使用AI生成代码。

{
  "name": "generate_code_with_ai",
  "arguments": {
    "description": "带有生物识别认证和错误处理的登录屏幕",
    "code_type": "compose_screen",
    "framework": "compose",
    "compliance_requirements": ["gdpr"],
    "include_tests": true,
    "style_guide": "material3"
  }
}

文件管理工具

22. manage_project_files - 高级文件操作

执行全面的文件管理操作。

{
  "name": "manage_project_files",
  "arguments": {
    "operation": "backup",
    "include_build_files": false,
    "compression": "zip",
    "encryption": true,
    "backup_location": "/path/to/backup",
    "exclude_patterns": ["*.tmp", "build/", ".gradle/"]
  }
}

操作：

• backup：创建加密备份。
• restore：从备份中恢复。
• sync：与云存储同步。
• encrypt：加密敏感文件。
• decrypt：解密文件（需适当授权）。
• organize：按类型/类别组织文件。

23. setup_cloud_sync - 云存储集成

配置云存储同步，并进行加密。

{
  "name": "setup_cloud_sync",
  "arguments": {
    "cloud_provider": "aws_s3",
    "bucket_name": "my-app-backup",
    "encryption_in_transit": true,
    "encryption_at_rest": true,
    "sync_frequency": "hourly",
    "compliance_mode": "gdpr"
  }
}

API集成工具

24. setup_external_api - API配置

设置外部API集成，包括安全和监控。

{
  "name": "setup_external_api",
  "arguments": {
    "api_name": "PaymentAPI",
    "base_url": "https://api.payment.com/v1/",
    "auth_type": "oauth2",
    "auth_config": {
      "client_id": "your_client_id",
      "scopes": ["payments", "users"]
    },
    "rate_limiting": {
      "requests_per_minute": 100,
      "burst_limit": 10
    },
    "security_features": ["request_signing", "response_validation"],
    "monitoring": true
  }
}

25. call_external_api - API调用

进行安全的API调用，并提供全面的监控。

{
  "name": "call_external_api",
  "arguments": {
    "api_name": "PaymentAPI",
    "endpoint": "/charges",
    "method": "POST",
    "data": {
      "amount": 1000,
      "currency": "USD",
      "description": "测试支付"
    },
    "headers": {
      "Content-Type": "application/json"
    },
    "timeout": 30,
    "retry_config": {
      "max_retries": 3,
      "backoff_strategy": "exponential"
    }
  }
}

测试工具

26. generate_unit_tests - 单元测试生成

为Kotlin类生成全面的单元测试。

{
  "name": "generate_unit_tests",
  "arguments": {
    "file_path": "src/main/kotlin/UserRepository.kt",
    "test_framework": "junit5",
    "mocking_framework": "mockk",
    "include_edge_cases": true,
    "test_coverage_target": 90
  }
}

27. setup_ui_testing - UI测试配置

使用Espresso或Compose测试框架设置UI测试。

{
  "name": "setup_ui_testing",
  "arguments": {
    "testing_framework": "compose",
    "include_accessibility_tests": true,
    "include_screenshot_tests": true,
    "test_data_setup": "in_memory_database"
  }
}

Git工具

28. gitStatus - Git仓库状态

获取全面的Git仓库状态，包括分支、更改和领先/落后计数。

{
  "name": "gitStatus",
  "arguments": {}
}

返回值：

• 当前分支名称。
• 带有状态的更改文件列表。
• 相对于远程的领先/落后计数。
• 仓库是否有未提交的更改。

29. gitSmartCommit - 智能提交消息

根据代码更改分析创建符合规范的提交消息。

{
  "name": "gitSmartCommit",
  "arguments": {}
}

特性：

• 分析更改的文件以确定提交类型。
• 生成符合规范的提交消息。
• 自动暂存更改。
• 支持feat、fix、docs、refactor、test类型。

30. gitCreateFeatureBranch - 安全分支创建

创建符合验证和命名约定的功能分支。

{
  "name": "gitCreateFeatureBranch",
  "arguments": {
    "branchName": "user-authentication"
  }
}

特性：

• 创建feature/branch-name格式的分支。
• 验证分支名称格式。
• 检查是否存在现有分支。
• 自动切换到新分支。

31. gitMergeWithResolution - 智能合并

尝试合并并进行冲突解决和提供建议。

{
  "name": "gitMergeWithResolution",
  "arguments": {
    "targetBranch": "main"
  }
}

特性：

• 尝试自动合并。
• 提供冲突解决建议。
• 返回结构化的冲突块。
• 提供合并策略建议。

外部API工具

32. apiCallSecure - 安全API调用

进行经过身份验证的API调用，并进行监控和合规检查。

{
  "name": "apiCallSecure",
  "arguments": {
    "apiName": "github",
    "endpoint": "/repos/owner/repo/issues",
    "method": "GET",
    "auth": {
      "type": "bearer",
      "token": "ghp_..."
    }
  }
}

特性：

• 多种身份验证类型（Bearer、API密钥、OAuth、基本认证）。
• 自动重试和退避策略。
• 请求/响应监控。
• 合规验证。

33. apiMonitorMetrics - API指标监控

获取实时的API使用指标和性能数据。

{
  "name": "apiMonitorMetrics",
  "arguments": {
    "apiName": "github",
    "windowMinutes": 60
  }
}

返回值：

• 请求计数和成功率。
• 平均延迟。
• 错误计数。
• 窗口化指标（1分钟到7天）。

34. apiValidateCompliance - API合规验证

验证API使用是否符合GDPR/HIPAA合规规则。

{
  "name": "apiValidateCompliance",
  "arguments": {
    "apiName": "payment-api",
    "complianceType": "gdpr"
  }
}

验证内容：

• 数据处理实践。
• 隐私政策合规性。
• 审计日志要求。
• 提供可操作的补救措施。

提高开发效率的工具

35. projectSearch - 快速项目搜索

在项目文件中进行快速grep搜索，并提供上下文。

{
  "name": "projectSearch",
  "arguments": {
    "query": "TODO|FIXME",
    "includePattern": "*.kt",
    "maxResults": 50,
    "contextLines": 2
  }
}

特性：

• 使用ripgrep提高速度。
• 匹配结果周围的上下文行。
• 支持正则表达式模式。
• 文件类型过滤。

36. todoListFromCode - TODO/FIXME提取

从代码库中解析和组织TODO/FIXME注释。

{
  "name": "todoListFromCode",
  "arguments": {
    "includePattern": "*.{kt,java,py,js,ts}",
    "maxResults": 100
  }
}

返回值：

• 按优先级组织（FIXME > TODO > XXX > HACK）。
• 文件位置和行号。
• 完整的注释上下文。
• 摘要统计信息。

37. readmeGenerateOrUpdate - README管理

生成或更新README文件，包括徽章、设置说明和工具目录。

{
  "name": "readmeGenerateOrUpdate",
  "arguments": {
    "forceRegenerate": false
  }
}

生成内容：

• 构建状态徽章。
• 设置和使用说明。
• 完整的工具目录。
• 环境变量文档。

38. changelogSummarize - 变更日志处理

将符合规范的提交汇总为分组的发布说明。

{
  "name": "changelogSummarize",
  "arguments": {
    "changelogPath": "CHANGELOG.md",
    "version": "latest"
  }
}

按类型分组提交：

• 功能特性。
• 错误修复。
• 文档更新。
• 重大变更。

39. buildAndTest - 构建和测试管道

运行Gradle/Maven构建并返回详细的测试结果。

{
  "name": "buildAndTest",
  "arguments": {
    "buildTool": "auto",
    "skipTests": false
  }
}

返回值：

• 构建成功/失败。
• 失败测试的详细信息。
• 构建工件。
• 性能指标。

40. dependencyAudit - 依赖项安全审计

审计Gradle依赖项的漏洞和许可证合规性。

{
  "name": "dependencyAudit",
  "arguments": {}
}

检查内容：

• OSV漏洞数据库。
• 许可证兼容性。
• 过时的依赖项。
• 安全公告。

41. securityHardening - 安全强化管理

管理安全强化功能，包括基于角色的访问控制（RBAC）、速率限制、缓存和监控。

{
  "name": "securityHardening",
  "arguments": {
    "operation": "get_metrics"
  }
}

操作：

• get_metrics - 获取安全指标和监控数据。
• assign_role - 分配用户角色（管理员、开发者、只读、访客）。
• check_permission - 检查用户对操作的权限。
• clear_cache - 清除安全缓存。
• export_telemetry - 导出遥测数据。

特性：

• 基于角色的访问控制（RBAC）。
• 滑动窗口速率限制。
• 断路器模式。
• 基于TTL的缓存。
• 全面的指标收集。
• 遥测数据导出功能。

🚀 快速开始工具示例

完整项目设置工作流

以下是一个逐步的工作流，用于设置一个具有企业级特性的新Android项目：

# 1. 分析现有项目结构
{
  "name": "analyze_project",
  "arguments": {
    "analysis_type": "architecture",
    "include_dependencies": true
  }
}

# 2. 设置MVVM架构
{
  "name": "setup_mvvm_architecture", 
  "arguments": {
    "feature_name": "UserManagement",
    "package_name": "com.example.users",
    "include_repository": true,
    "state_management": "compose"
  }
}

# 3. 配置依赖注入
{
  "name": "setup_dependency_injection",
  "arguments": {
    "di_framework": "hilt",
    "modules": ["DatabaseModule", "NetworkModule"]
  }
}

# 4. 设置安全数据库
{
  "name": "setup_room_database",
  "arguments": {
    "database_name": "AppDatabase",
    "entities": [
      {
        "name": "User",
        "fields": [
          {"name": "id", "type": "String", "primaryKey": true},
          {"name": "name", "type": "String"},
          {"name": "email", "type": "String"}
        ]
      }
    ],
    "enable_encryption": true
  }
}

# 5. 实现合规性（如果需要）
{
  "name": "implement_gdpr_compliance",
  "arguments": {
    "package_name": "com.example.app",
    "features": ["consent_management", "data_portability"],
    "include_ui": true
  }
}

# 6. 生成UI组件
{
  "name": "create_compose_component",
  "arguments": {
    "component_name": "UserListScreen",
    "component_type": "stateful",
    "include_preview": true,
    "material_design": "material3"
  }
}

# 7. 设置API集成
{
  "name": "setup_retrofit_api",
  "arguments": {
    "base_url": "https://api.example.com/",
    "endpoints": [
      {
        "name": "getUsers",
        "method": "GET", 
        "path": "users",
        "response_type": "List<User>"
      }
    ],
    "include_interceptors": ["logging", "auth"]
  }
}

# 8. 生成全面测试
{
  "name": "generate_unit_tests",
  "arguments": {
    "file_path": "src/main/kotlin/UserRepository.kt",
    "test_framework": "junit5",
    "include_edge_cases": true
  }
}

# 9. 构建和测试
{
  "name": "gradle_build",
  "arguments": {
    "task": "assembleDebug",
    "clean_build": true
  }
}

{
  "name": "run_tests",
  "arguments": {
    "test_type": "all",
    "generate_report": true
  }
}

AI驱动的开发示例

# 使用AI生成完整的登录功能
{
  "name": "generate_code_with_ai",
  "arguments": {
    "description": "完整的登录功能，包括电子邮件/密码、生物识别认证、记住我选项、忘记密码流程和正确的错误处理",
    "code_type": "feature",
    "framework": "compose",
    "compliance_requirements": ["gdpr"],
    "include_tests": true
  }
}

# 分析现有代码的安全问题
{
  "name": "analyze_code_with_ai",
  "arguments": {
    "file_path": "src/main/kotlin/AuthManager.kt",
    "analysis_type": "security",
    "detailed_report": true
  }
}

# 获取AI协助进行复杂实现
{
  "name": "query_llm",
  "arguments": {
    "prompt": "如何在Android中实现安全的生物识别认证，并在失败时回退到PIN码？包括对不同生物识别状态的错误处理。",
    "llm_provider": "local",
    "privacy_mode": true
  }
}

🛠️ 工具使用最佳实践

文件路径约定

始终使用相对于项目根目录的路径：

# ✅ 正确
"file_path": "src/main/kotlin/com/example/User.kt"

# ❌ 错误  
"file_path": "/absolute/path/to/User.kt"

包命名

遵循Android包命名约定：

# ✅ 正确
"package_name": "com.company.app.feature.user"

# ❌ 错误
"package_name": "User.Package"

安全最佳实践

• 始终对敏感数据使用加密。
• 从一开始就实现适当的合规功能。
• 使用安全存储来保存API密钥和机密信息。
• 启用审计日志以满足合规要求。

性能优化

• 尽可能在Gradle构建中使用parallel: true。
• 逐步生成测试，而不是一次性生成所有测试。
• 对于隐私敏感的代码分析，使用本地大语言模型提供商。
• 为API设置启用缓存。

错误处理

所有工具都提供全面的错误信息：

{
  "success": false,
  "error": "文件已存在",
  "details": {
    "file_path": "src/main/kotlin/User.kt",
    "suggestion": "使用不同的文件名或设置overwrite: true"
  }
}

📊 工具响应格式

成功响应

{
  "success": true,
  "result": {
    "files_created": ["User.kt", "UserTest.kt"],
    "lines_of_code": 125,
    "compilation_status": "success"
  },
  "metadata": {
    "execution_time": "2.3s",
    "tools_used": ["kotlin_compiler", "test_generator"]
  }
}

错误响应

{
  "success": false,
  "error": "编译失败",
  "details": {
    "error_type": "compilation_error",
    "line_number": 23,
    "message": "未解析的引用: undefinedVariable",
    "suggestions": [
      "检查变量声明",
      "验证导入"
    ]
  }
}

🔒 安全与隐私特性

GDPR合规实现

{
  "name": "implement_gdpr_compliance",
  "arguments": {
    "package_name": "com.example.app",
    "features": [
      "consent_management",
      "data_portability", 
      "right_to_erasure",
      "privacy_policy"
    ]
  }
}

生成的特性：

• 同意管理UI组件。
• 数据导出功能。
• 用户数据删除工作流。
• 隐私政策模板。
• 法律依据跟踪。

HIPAA合规实现

{
  "name": "implement_hipaa_compliance",
  "arguments": {
    "package_name": "com.healthcare.app",
    "features": [
      "audit_logging",
      "access_controls",
      "encryption",
      "secure_messaging"
    ]
  }
}

生成的特性：

• 全面的审计日志系统。
• 基于角色的访问控制框架。
• 受保护健康信息（PHI）加密实用工具。
• 安全消息传递基础设施。
• 风险评估工具。

数据加密

{
  "name": "encrypt_sensitive_data",
  "arguments": {
    "data": "患者: 约翰· Doe，社保号: 123 - 45 - 6789",
    "data_type": "phi",
    "compliance_level": "hipaa"
  }
}

安全存储设置

{
  "name": "setup_secure_storage",
  "arguments": {
    "storage_type": "room_encrypted",
    "package_name": "com.example.app",
    "data_classification": "restricted"
  }
}

🤖 AI集成特性

本地大语言模型查询

{
  "name": "query_llm", 
  "arguments": {
    "prompt": "生成一个带有验证的Kotlin数据类User",
    "llm_provider": "local",
    "privacy_mode": true,
    "max_tokens": 1000
  }
}

AI驱动的代码分析

{
  "name": "analyze_code_with_ai",
  "arguments": {
    "file_path": "src/main/UserManager.kt",
    "analysis_type": "security",
    "use_local_model": true
  }
}

分析类型：

• security - 漏洞和安全最佳实践。
• performance - 性能优化建议。
• bugs - 潜在的bug检测。
• style - 代码风格和格式化改进。
• complexity - 代码复杂性分析。

AI代码生成

{
  "name": "generate_code_with_ai",
  "arguments": {
    "description": "带有生物识别认证的登录屏幕",
    "code_type": "component",
    "framework": "compose",
    "compliance_requirements": ["gdpr", "hipaa"]
  }
}

代码类型：

• class - 带有方法的Kotlin类。
• function - 独立函数。
• layout - XML布局文件。
• test - 单元和集成测试。
• component - Jetpack Compose组件。

📁 文件管理操作

高级备份

{
  "name": "manage_project_files",
  "arguments": {
    "operation": "backup",
    "target_path": "./src",
    "destination": "./backups",
    "encryption_level": "high"
  }
}

实时同步

{
  "name": "manage_project_files",
  "arguments": {
    "operation": "sync",
    "target_path": "./src",
    "destination": "./remote-sync",
    "sync_strategy": "real_time"
  }
}

云存储同步

{
  "name": "setup_cloud_sync",
  "arguments": {
    "cloud_provider": "aws",
    "sync_strategy": "scheduled",
    "encryption_in_transit": true,
    "compliance_mode": "gdpr"
  }
}

支持的操作：

• backup - 创建带有清单的加密备份。
• restore - 从备份中恢复，并进行完整性检查。
• sync - 双向同步，解决冲突。
• encrypt - 就地加密敏感文件。
• decrypt - 解密文件（需适当授权）。
• archive - 创建压缩存档。
• extract - 提取存档并进行验证。
• search - 基于内容的文件发现。
• analyze - 文件结构和使用分析。

🌐 外部API集成

API集成设置

{
  "name": "integrate_external_api",
  "arguments": {
    "api_name": "HealthRecordsAPI",
    "base_url": "https://api.healthrecords.com",
    "auth_type": "oauth",
    "security_features": [
      "rate_limiting",
      "request_logging", 
      "response_validation"
    ],
    "compliance_requirements": ["hipaa"]
  }
}

API使用监控

{
  "name": "monitor_api_usage",
  "arguments": {
    "api_name": "HealthRecordsAPI",
    "metrics": [
      "latency",
      "error_rate",
      "usage_volume",
      "cost"
    ],
    "alert_thresholds": {
      "error_rate": 5.0,
      "latency_ms": 2000
    }
  }
}

认证类型：

• none - 无需认证。
• api_key - 在头部或查询中使用API密钥。
• oauth - OAuth 2.0流程。
• jwt - JSON Web Token。
• basic - 基本HTTP认证。

🏗️ 高级Android开发

MVVM架构设置

{
  "name": "setup_mvvm_architecture",
  "arguments": {
    "feature_name": "UserProfile",
    "package_name": "com.example.app",
    "include_repository": true,
    "include_use_cases": true,
    "data_source": "both"
  }
}

Jetpack Compose组件

{
  "name": "create_compose_component",
  "arguments": {
    "file_path": "ui/components/LoginForm.kt",
    "component_name": "LoginForm",
    "component_type": "component",
    "package_name": "com.example.ui",
    "uses_state": true,
    "uses_navigation": false
  }
}

Room数据库设置

{
  "name": "setup_room_database",
  "arguments": {
    "database_name": "AppDatabase",
    "package_name": "com.example.data",
    "entities": ["User", "Profile", "Settings"],
    "include_migration": true
  }
}

Retrofit API客户端

{
  "name": "setup_retrofit_api",
  "arguments": {
    "api_name": "UserApiService",
    "package_name": "com.example.network",
    "base_url": "https://api.example.com",
    "endpoints": [
      {
        "method": "GET",
        "path": "/users/{id}",
        "name": "getUser"
      }
    ],
    "include_interceptors": true
  }
}

依赖注入（Hilt）

{
  "name": "setup_dependency_injection",
  "arguments": {
    "module_name": "NetworkModule",
    "package_name": "com.example.di",
    "injection_type": "network"
  }
}

ML模型集成

{
  "name": "integrate_ml_model",
  "arguments": {
    "model_type": "tflite",
    "model_path": "assets/model.tflite",
    "use_case": "image_classification",
    "privacy_preserving": true
  }
}

🛠️ 特定工具故障排除

Gradle构建问题

# 工具: gradle_build
# 常见解决方案:

# 1. 清除Gradle缓存
{
  "name": "gradle_build",
  "arguments": {
    "task": "clean",
    "clean_build": true
  }
}

# 2. 检查Java版本
echo $JAVA_HOME
java -version

# 3. 修复权限问题（macOS/Linux）
chmod +x gradlew

# 4. 启用详细输出进行调试
{
  "name": "