AI导哈

Xcode项目文件操作服务

pbxproj-mcp是一个用于读写Xcode项目文件的MCP服务器，支持AI助手直接操作Xcode项目。

  • by hiragram
  • Swift
  • 本地部署
  • 更新于
在 GitHub 查看 hiragram/pbxproj-mcp

使用说明

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

依赖项

许可证

麻省理工学院

相关 MCP