代码生成与项目管理工具

SwiftStudio 是一个专注于为 macOS 和 iOS 开发提供代码生成、项目管理和开发者智能的 MCP 服务器工具。

  • by codebygarrett
  • Swift
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 codebygarrett/SwiftStudio

使用说明

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": []
    }
  }
}

建筑

swift build -c release

可执行文件将位于 .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

技术栈

发展

运行测试

swift test

项目结构

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设计指南。