xcodeproj-mcp-server

xcodeproj-mcp-serverは、Swiftを使用してXcodeプロジェクトファイル(.xcodeproj)をプログラム的に操作するためのモデルコンテキストプロトコル(MCP)サーバーです。このツールは、Xcodeプロジェクトの構成を自動化し、開発者が効率的にプロジェクトを管理できるようにします。

GitHubスター

95

ユーザー評価

未評価

お気に入り

0

閲覧数

138

フォーク

3

イシュー

2

インストール方法
難易度
中級
推定所要時間
10-20
必要な環境
Swift 6.1以上
Xcode 16.4以上

インストール方法

インストール方法

前提条件

必要なソフトウェアとバージョンを明記してください。
Swift: 6.1以上
Xcode: 16.4以上

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/giginet/xcodeproj-mcp-server.git
cd xcodeproj-mcp-server

2. 依存関係のインストール

bash
swift package resolve

3. サーバーの起動

bash
swift run

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Swiftのバージョンを確認し、依存関係を再インストールしてください。 問題: プロジェクトファイルが正しく操作できない 解決策: Xcodeプロジェクトのパスが正しいか確認してください。

設定方法

設定方法

基本設定

サーバー設定

サーバーの設定は特に必要ありませんが、必要に応じて環境変数を設定できます。

環境変数

必要に応じて以下の環境変数を設定:
bash
export MCP_SERVER_PORT=3000
export LOG_LEVEL=info

詳細設定

セキュリティ設定

APIキーや機密情報は環境変数または安全な設定ファイルに保存
ファイルアクセス権限の適切な設定

パフォーマンス調整

タイムアウト値の設定
同時実行数の制限

設定例

json
{
  "mcpServers": {
    "xcodeproj-mcp-server": {
      "command": "swift",
      "args": ["run", "xcodeproj-mcp-server"],
      "env": {
        "MCP_SERVER_PORT": "3000"
      }
    }
  }
}

使用例

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します:

プログラムでの使用

swift
import Foundation

let server = MCPServer()
server.start()

// 新しいプロジェクトを作成する
let project = Project(name: "MyNewProject")
server.createProject(project)
print("プロジェクトが作成されました: \(project.name)")

応用例

自動化スクリプト

bash
#!/bin/bash

バッチ処理の例

for file in *.swift; do mcp-tool process "$file" done

使用ケース

新しいXcodeプロジェクトをゼロから作成し、カスタム設定やバンドル識別子を指定する。
複数のアプリ、フレームワーク、テスト、拡張を含む複雑なプロジェクトを自動化されたワークフローでスキャフォールディングする。
新しいSwiftファイルを作成した後、適切なターゲットのソースファイルに自動的に追加する。
外部リソースフォルダやアセットディレクトリをプロジェクトに同期フォルダ参照として追加する。
ビルドフェーズにコードフォーマッターやリンターを統合する。

追加リソース