这是一个全面的模型上下文协议(MCP)服务器,为AI智能体提供企业级访问基于Kotlin的Android开发项目的能力。该服务器能够提供上下文感知的协助,并具备高级安全、隐私合规、AI集成和全面的开发工具。
增强版发布:统一智能服务器
kotlin_mcp_server.py
文件,架构得到增强。kotlin_mcp_server.py
文件取代了多个服务器版本。archive/legacy-servers/
目录中。IntelligentMCPToolManager
集成,具备高级功能。重大版本发布:AI增强的模块化架构
ai/
、android/
、gradle/
、security/
、testing/
、utils/
模块。~
符号取代特定于操作系统的硬编码路径。初始版本发布:基于模板的代码生成器
🤖 AI增强开发:现在利用AI助手生成可投入生产的代码,而不是基本模板!
升级前 (V1.0):
升级后 (V2.0):
python3 install.py
命令可处理所有配置。git clone
cd kotlin-mcp-server
项目包含一个增强的安装脚本,可自动处理所有配置:
# 交互式安装(推荐首次使用的用户)
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
安装程序的功能:
requirements.txt
文件中安装。如果您更喜欢手动安装:
# 安装核心依赖项
pip install -r requirements.txt
# 可选:安装AI/ML依赖项以使用高级功能
pip install openai anthropic transformers torch
# 验证安装
python3 -c "import kotlin_mcp_server; print('✅ 安装成功')"
已安装的关键依赖项:
python-dotenv
、pydantic
cryptography
、bcrypt
、PyJWT
aiosqlite
、sqlalchemy
aiohttp
、httpx
aiofiles
、watchdog
pytest
、pytest-asyncio
、coverage
black
、flake8
、pylint
、mypy
bandit
、safety
🏗️ 模块化架构设计
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实现 |
测试 | 测试存根 | 包含边缘情况的全面测试套件 |
安全 | 基本验证 | 具备合规性的企业级安全 |
⚡ 性能与可靠性改进
安装完成后,脚本会生成可直接使用的配置文件:
mcp_config_claude.json
- 用于Claude Desktop。mcp_config_vscode.json
- 用于VS Code和Cursor。mcp_config.json
- 用于其他MCP客户端。集成说明:
🔹 Claude Desktop:将mcp_config_claude.json
的内容复制到:
~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.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客户端集成。
对于需要自定义环境设置的高级用户:
在项目根目录下创建一个.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集成或自定义安全设置)时才需要。
请参阅下面的插件要求部分,了解特定于IDE的扩展。
# 使用您配置的设置测试服务器
# 如果您在安装过程中使用了固定的项目路径:
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
增强的安装过程消除了手动配置的需要:
✅ 之前(手动):用户必须手动编辑配置文件、查找路径、更新环境变量。 ✅ 之后(自动化):一个命令即可创建所有可直接使用的配置。
关键改进:
对于容器化部署,项目提供了全面的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-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应用了吗? 按照以下步骤,体验完整的端到端工作流程:
# 1. 构建Kotlin边车(创建胖JAR)
make sidecar
# 2. 生成具有所有功能的完整Android应用
make e2e
# 3. 您的APK文件将出现在这里:
ls -la e2e/sampleapp/app/build/outputs/apk/debug/app-debug.apk
您将获得:
# 构建Kotlin边车JAR
make sidecar
# 生成完整的Android应用
make e2e
# 格式化和优化代码
make fix
# 运行detekt静态分析
make detekt
# 运行spotless代码格式化检查
make spotless
# 清理所有工件
make clean
生成的e2e/sampleapp
应用包含:
🏗️ 架构:
🎨 UI/UX:
💾 数据层:
🌐 网络:
🧪 测试:
📱 构建:
# 边车配置
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
系统针对以下方面进行了优化:
当一切正常时:
kotlin-sidecar.jar
成功构建。e2e/sampleapp
目录创建,包含完整项目。./gradlew assembleDebug
无错误完成。app/build/outputs/apk/debug/app-debug.apk
。./gradlew testDebugUnitTest
测试通过。🎯 生成的应用可投入生产,可立即在Android Studio中打开!
如果您已经安装了V1.0版本:
备份当前设置:
# 备份您现有的配置
cp mcp_config*.json ~/backup/
更新到V2.0:
# 拉取最新更改
git pull origin main
# 运行V2.0安装程序
python3 install.py 1
验证迁移:
# 测试新的模块化架构
python3 -c "from kotlin_mcp_server import KotlinMCPServer; print('✅ V2.0就绪!')"
.env.example
)。Kotlin MCP服务器中的所有工具都经过重构,仅在用户的项目工作区中运行,而不会在MCP服务器的当前工作目录中运行。这确保了工具行为的安全性和可预测性,防止意外修改项目外的文件。
工具按以下顺序解析项目根目录:
project_root
或projectRoot
参数。PROJECT_PATH
或WORKSPACE_PATH
。工具接受驼峰命名法和蛇形命名法的参数名称:
// 两种格式的效果相同
{
"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扩展(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个全面的工具,按类别组织:
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"}}
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测试报告。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
(字符串,可选):包声明。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
}
}
analyze_project
- 项目分析对您的Android项目结构、依赖项和架构进行全面分析。
{
"name": "analyze_project",
"arguments": {
"analysis_type": "architecture",
"include_dependencies": true,
"check_best_practices": true
}
}
分析类型:
architecture
:整体项目结构和模式。dependencies
:Gradle依赖项和版本。security
:安全漏洞和最佳实践。performance
:性能瓶颈和优化建议。format_code
- 代码格式化根据风格指南格式化Kotlin代码。
{
"name": "format_code",
"arguments": {
"file_path": "src/main/kotlin/MainActivity.kt",
"style_guide": "ktlint"
}
}
run_lint
- 静态代码分析运行Lint分析,检测代码问题。
{
"name": "run_lint",
"arguments": {
"lint_tool": "detekt",
"fail_on_warnings": false,
"generate_report": true
}
}
generate_docs
- 文档生成以各种格式生成项目文档。
{
"name": "generate_docs",
"arguments": {
"doc_type": "kdoc",
"output_format": "html",
"include_private": false
}
}
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
:带有子组件的布局可组合函数。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"}
]
}
}
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"
}
}
生成的文件:
setup_dependency_injection
- 依赖注入框架设置使用Hilt或Dagger配置依赖注入。
{
"name": "setup_dependency_injection",
"arguments": {
"di_framework": "hilt",
"modules": ["DatabaseModule", "NetworkModule", "RepositoryModule"],
"application_class": "MyApplication"
}
}
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
}
}
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
}
}
encrypt_sensitive_data
- 数据加密使用行业标准的加密算法加密敏感数据。
{
"name": "encrypt_sensitive_data",
"arguments": {
"data": "患者: 约翰· Doe,社保号: 123 - 45 - 6789",
"data_type": "phi",
"compliance_level": "hipaa",
"encryption_algorithm": "AES - 256"
}
}
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
}
}
生成的组件:
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
}
}
setup_secure_storage
- 安全数据存储配置用于敏感数据的加密存储。
{
"name": "setup_secure_storage",
"arguments": {
"storage_type": "room_encrypted",
"package_name": "com.example.app",
"data_classification": "restricted",
"key_management": "android_keystore"
}
}
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端点。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
:可维护性评估。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"
}
}
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
:按类型/类别组织文件。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"
}
}
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
}
}
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"
}
}
}
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
}
}
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"
}
}
gitStatus
- Git仓库状态获取全面的Git仓库状态,包括分支、更改和领先/落后计数。
{
"name": "gitStatus",
"arguments": {}
}
返回值:
gitSmartCommit
- 智能提交消息根据代码更改分析创建符合规范的提交消息。
{
"name": "gitSmartCommit",
"arguments": {}
}
特性:
gitCreateFeatureBranch
- 安全分支创建创建符合验证和命名约定的功能分支。
{
"name": "gitCreateFeatureBranch",
"arguments": {
"branchName": "user-authentication"
}
}
特性:
feature/branch-name
格式的分支。gitMergeWithResolution
- 智能合并尝试合并并进行冲突解决和提供建议。
{
"name": "gitMergeWithResolution",
"arguments": {
"targetBranch": "main"
}
}
特性:
apiCallSecure
- 安全API调用进行经过身份验证的API调用,并进行监控和合规检查。
{
"name": "apiCallSecure",
"arguments": {
"apiName": "github",
"endpoint": "/repos/owner/repo/issues",
"method": "GET",
"auth": {
"type": "bearer",
"token": "ghp_..."
}
}
}
特性:
apiMonitorMetrics
- API指标监控获取实时的API使用指标和性能数据。
{
"name": "apiMonitorMetrics",
"arguments": {
"apiName": "github",
"windowMinutes": 60
}
}
返回值:
apiValidateCompliance
- API合规验证验证API使用是否符合GDPR/HIPAA合规规则。
{
"name": "apiValidateCompliance",
"arguments": {
"apiName": "payment-api",
"complianceType": "gdpr"
}
}
验证内容:
projectSearch
- 快速项目搜索在项目文件中进行快速grep搜索,并提供上下文。
{
"name": "projectSearch",
"arguments": {
"query": "TODO|FIXME",
"includePattern": "*.kt",
"maxResults": 50,
"contextLines": 2
}
}
特性:
todoListFromCode
- TODO/FIXME提取从代码库中解析和组织TODO/FIXME注释。
{
"name": "todoListFromCode",
"arguments": {
"includePattern": "*.{kt,java,py,js,ts}",
"maxResults": 100
}
}
返回值:
readmeGenerateOrUpdate
- README管理生成或更新README文件,包括徽章、设置说明和工具目录。
{
"name": "readmeGenerateOrUpdate",
"arguments": {
"forceRegenerate": false
}
}
生成内容:
changelogSummarize
- 变更日志处理将符合规范的提交汇总为分组的发布说明。
{
"name": "changelogSummarize",
"arguments": {
"changelogPath": "CHANGELOG.md",
"version": "latest"
}
}
按类型分组提交:
buildAndTest
- 构建和测试管道运行Gradle/Maven构建并返回详细的测试结果。
{
"name": "buildAndTest",
"arguments": {
"buildTool": "auto",
"skipTests": false
}
}
返回值:
dependencyAudit
- 依赖项安全审计审计Gradle依赖项的漏洞和许可证合规性。
{
"name": "dependencyAudit",
"arguments": {}
}
检查内容:
securityHardening
- 安全强化管理管理安全强化功能,包括基于角色的访问控制(RBAC)、速率限制、缓存和监控。
{
"name": "securityHardening",
"arguments": {
"operation": "get_metrics"
}
}
操作:
get_metrics
- 获取安全指标和监控数据。assign_role
- 分配用户角色(管理员、开发者、只读、访客)。check_permission
- 检查用户对操作的权限。clear_cache
- 清除安全缓存。export_telemetry
- 导出遥测数据。特性:
以下是一个逐步的工作流,用于设置一个具有企业级特性的新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"
}
],
"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生成完整的登录功能
{
"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"
parallel: true
。所有工具都提供全面的错误信息:
{
"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": [
"检查变量声明",
"验证导入"
]
}
}
{
"name": "implement_gdpr_compliance",
"arguments": {
"package_name": "com.example.app",
"features": [
"consent_management",
"data_portability",
"right_to_erasure",
"privacy_policy"
]
}
}
生成的特性:
{
"name": "implement_hipaa_compliance",
"arguments": {
"package_name": "com.healthcare.app",
"features": [
"audit_logging",
"access_controls",
"encryption",
"secure_messaging"
]
}
}
生成的特性:
{
"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"
}
}
{
"name": "query_llm",
"arguments": {
"prompt": "生成一个带有验证的Kotlin数据类User",
"llm_provider": "local",
"privacy_mode": true,
"max_tokens": 1000
}
}
{
"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
- 代码复杂性分析。{
"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
- 文件结构和使用分析。{
"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"]
}
}
{
"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认证。{
"name": "setup_mvvm_architecture",
"arguments": {
"feature_name": "UserProfile",
"package_name": "com.example.app",
"include_repository": true,
"include_use_cases": true,
"data_source": "both"
}
}
{
"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
}
}
{
"name": "setup_room_database",
"arguments": {
"database_name": "AppDatabase",
"package_name": "com.example.data",
"entities": ["User", "Profile", "Settings"],
"include_migration": true
}
}
{
"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
}
}
{
"name": "setup_dependency_injection",
"arguments": {
"module_name": "NetworkModule",
"package_name": "com.example.di",
"injection_type": "network"
}
}
{
"name": "integrate_ml_model",
"arguments": {
"model_type": "tflite",
"model_path": "assets/model.tflite",
"use_case": "image_classification",
"privacy_preserving": true
}
}
# 工具: 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": "