pbxproj mcp
用于操作Xcode项目文件（.xcodeproj）的MCP（模型上下文协议）服务器。
概述
pbxproj-mcp是一个mcp服务器，它使用 XcodeProj 图书馆。它使像Claude这样的人工智能助手能够直接操纵Xcode项目。
特性
读取操作
| 工具 | 说明 |
|---|---|
get_project_info | 获取项目基本信息 |
list_targets | 列出所有目标 |
get_target_info | 获取特定目标的详细信息 |
list_files | 列出项目中的文件 |
list_groups | 列出项目中的组 |
list_configurations | 列出构建配置 |
get_build_settings | 获取构建设置 |
list_build_phases | 列出构建阶段 |
get_build_phase_files | 列出构建阶段的文件 |
list_packages | 列出Swift包依赖项 |
list_schemes | 列出方案 |
get_scheme_info | 获取详细方案信息 |
写入操作
| 工具 | 说明 |
|---|---|
update_build_setting | 更新生成设置 |
add_file | 将文件添加到项目中 |
remove_file | 从项目中删除文件 |
add_group | 添加组 |
add_file_to_build_phase | 将文件添加到构建阶段 |
add_run_script | 添加运行脚本阶段 |
update_run_script | 更新运行脚本阶段 |
add_target | 添加目标 |
add_target_dependency | 在目标之间添加依赖关系 |
add_swift_package | 添加远程Swift包 |
add_local_package | 添加本地Swift包 |
需求
- macOS 13.0+
- Swift 6.0+
- Xcode 15.0+
安装
构建
swift build -c release可执行文件将在以下时间生成 .build/release/pbxproj-mcp.
Claude桌面配置
添加以下内容 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"pbxproj": {
"command": "swx",
"args": ["hiragram/pbxproj-mcp"]
}
}
}使用示例
获取项目信息
Use get_project_info to check the project overview添加文件
Add NewFeature.swift to the Sources group更新生成设置
Update SWIFT_VERSION to 5.9发展
项目结构
pbxproj/
├── Package.swift
├── Sources/
│ ├── Core/ # Core library
│ │ └── XcodeProjService.swift
│ └── pbxproj-mcp/ # MCP server executable
│ ├── main.swift
│ └── ToolHandler.swift
└── Tests/
└── CoreTests/ # Unit tests
├── XcodeProjServiceTests.swift
├── XcodeProjServiceWriteTests.swift
└── Fixtures/ # Test fixtures运行测试
swift test依赖项
许可证
麻省理工学院