Swiftstudio MCP
专注于苹果原生开发MCP服务器 代码生成、项目操作和开发人员智能 用于macOS和iOS开发。
概述
SwiftStudio补充 XcodeBuildMCP 通过提供工作室工具,AI代理需要编写高质量的本机代码。
| MCP服务器 |
焦点 |
| XcodeBuildMCP |
构建、测试、调试、模拟器控制 |
| Swiftstudio |
代码生成、项目操作、资产、元数据 |
安装
克劳德代码
claude mcp add swift-studio -- /path/to/SwiftStudio
手动配置
添加到MCP设置中:
{
"mcpServers": {
"swift-studio": {
"command": "/path/to/SwiftStudio",
"args": []
}
}
}
建筑
可执行文件将位于 .build/release/SwiftStudio.
工具
项目操作(8个工具)
| 工具 |
说明 |
project_add_file |
将Swift/资源文件添加到目标 |
project_remove_file |
从项目中删除文件 |
project_add_target |
添加应用扩展、小部件、测试目标 |
project_list_targets |
列出具有配置的目标 |
project_get_structure |
返回项目文件树 |
project_add_framework |
将框架链接到目标 |
project_set_build_setting |
修改构建设置 |
project_add_capability |
启用权限(推送、iCloud等) |
代码生成(12个工具)
| 工具 |
说明 |
generate_swiftui_view |
带可选ViewModel的SwiftUI视图 |
generate_viewmodel |
Observable/Observable对象类 |
generate_swiftdata_model |
@具有关系的模型类 |
generate_coredata_entity |
NSManaged对象子类 |
generate_api_client |
异步/等待网络客户端 |
generate_protocol |
具有默认扩展名的协议 |
generate_extension |
带方法的Swift扩展 |
generate_test_file |
XCTest或Swift测试脚手架 |
generate_widget |
WidgetKit时间线+视图 |
generate_app_intent |
快捷方式的AppIntent/Siri |
generate_accessibility |
SwiftUI辅助工具 |
模板(4个工具)
| 工具 |
说明 |
template_list |
列出可用的代码模板 |
template_apply |
从带有变量的模板生成 |
template_create |
将代码另存为可重用模板 |
snippet_search |
按功能搜索模板 |
内置模板:
swiftui-list-detail -主细节导航模式
mvvm-feature -完整的MVVM模块(视图、ViewModel、模型、服务)
async-repository -具有缓存和错误处理功能的存储库
coordinator-pattern -类型安全导航协调员
form-validation -带字段验证的SwiftUI表单
Plist和元数据(6个工具)
| 工具 |
说明 |
plist_get |
读取plist值 |
plist_set |
写入plist值 |
plist_add_url_scheme |
注册URL方案 |
plist_add_usage_description |
添加隐私字符串 |
version_get |
阅读当前版本 |
version_bump |
增量版本/构建 |
资产管理(7个工具)
| 工具 |
说明 |
assets_add_image |
添加1x/2x/3x变体的图像 |
assets_add_color |
添加颜色集(浅色/深色) |
assets_add_app_icon |
从1024x1024源生成应用图标集 |
assets_add_symbol |
添加SF符号配置 |
assets_list |
列出目录内容 |
assets_validate |
检查缺失的变体 |
assets_export_constants |
生成Swift常量 |
本地化(6个工具)
| 工具 |
说明 |
strings_add_key |
将本地化密钥添加到.xcstring |
strings_update_translation |
更新语言的翻译 |
strings_list_untranslated |
查找缺失的翻译 |
strings_extract_from_code |
扫描Swift文件以查找可本地化的字符串 |
strings_export_xliff |
导出到XLIFF进行翻译 |
strings_import_xliff |
从XLIFF导入翻译 |
代码质量(6个工具)
| 工具 |
说明 |
lint_check |
在源文件上运行SwiftLint |
format_code |
使用swift格式格式化代码 |
organize_imports |
对导入进行排序和重复数据消除 |
modernize_syntax |
更新到现代Swift模式 |
check_concurrency |
验证Swift 6并发安全性 |
suggest_refactor |
建议重构机会 |
文档(5个工具)
| 工具 |
说明 |
docs_generate_header |
为功能/类型生成文档注释 |
docs_validate |
检查文件覆盖范围 |
docs_generate_readme |
从公共API创建自述文件 |
docs_extract_api |
提取公共API文档 |
docs_generate_changelog |
从git历史生成更改日志 |
工作空间管理(5个工具)
| 工具 |
说明 |
workspace_list_projects |
列出工作区中的所有项目 |
workspace_add_project |
将项目添加到工作区 |
workspace_remove_project |
从工作区中删除项目 |
workspace_create |
使用项目创建新的工作区 |
workspace_get_structure |
获取工作空间结构 |
Swift包(7个工具)
| 工具 |
说明 |
package_info |
获取Swift包信息 |
package_list_dependencies |
列出包依赖关系 |
package_add_dependency |
向Package.swift添加依赖项 |
package_remove_dependency |
从Package.swift中删除依赖关系 |
package_add_target |
将目标添加到Package.swift |
package_update_tools_version |
更新swift工具版本 |
package_resolve |
解决或更新依赖关系 |
XCConfig(6个工具)
| 工具 |
说明 |
xcconfig_create |
创建新的xcconfig文件 |
xcconfig_read |
读取并解析xcconfig |
xcconfig_get_setting |
获取特定的构建设置 |
xcconfig_set_setting |
设置构建设置值 |
xcconfig_generate |
从模板生成(调试/发布/共享) |
xcconfig_validate |
验证xcconfig语法 |
CI/CD(5个工具)
| 工具 |
说明 |
cicd_github_actions |
生成GitHub操作工作流 |
cicd_xcode_cloud |
生成Xcode云配置 |
cicd_fastlane |
生成Fastlane配置 |
cicd_makefile |
为开发任务生成Makefile |
cicd_gitlab |
生成GitLab CI配置 |
工作流示例
User: "Add a profile widget to my app"
Claude orchestrates:
1. SwiftStudio: generate_widget(name: "ProfileWidget", ...)
2. SwiftStudio: project_add_file(filePath: "ProfileWidget.swift", ...)
3. SwiftStudio: project_add_target(targetType: "widget", ...)
4. SwiftStudio: assets_add_image(name: "widget-background", ...)
5. XcodeBuildMCP: build_sim(scheme: "ProfileWidgetExtension")
6. XcodeBuildMCP: build_run_sim() → verify in simulator
技术栈
发展
运行测试
项目结构
SwiftStudio/
├── Package.swift
├── Sources/
│ ├── SwiftStudio/ # Main executable
│ │ └── main.swift
│ └── SwiftStudioCore/ # Core library
│ ├── SwiftStudioServer.swift
│ ├── Tools/
│ │ ├── ProjectTools.swift
│ │ ├── CodeGenerator.swift
│ │ ├── PlistTools.swift
│ │ ├── AssetTools.swift
│ │ ├── LocalizationTools.swift
│ │ ├── TemplateTools.swift
│ │ ├── QualityTools.swift
│ │ ├── DocumentationTools.swift
│ │ ├── WorkspaceTools.swift
│ │ ├── PackageTools.swift
│ │ ├── XCConfigTools.swift
│ │ └── CICDTools.swift
│ └── Models/
│ └── SwiftStudioError.swift
└── Tests/
└── SwiftStudioTests/
许可证
麻省理工学院
贡献
PR欢迎。请遵循Swift API设计指南。