Xcsift MCP

🚀 xcsift-mcp

xcsift をラップするMCP（Model Context Protocol）サーバーです。これにより、AIコーディングアシスタントがXcodeのビルド出力を構造化されたトークン効率の良い形式に解析できるようになります。

🚀 クイックスタート

xcsift-mcp は、Claude、OpenCode、CursorなどのAIコーディングアシスタントに以下のツールを提供します。

• 生の xcodebuild または swift build/test 出力を構造化されたJSONまたはTOON形式に 解析 する
• ビルドコマンドを 実行 し、自動的に解析結果を取得する
• エラー、警告、テスト失敗、リンカーエラーをファイル/行情報とともに 抽出 する
• テスト実行からコードカバレッジを 分析 する

出力はトークン効率が最適化されており、TOON形式はJSONと比較して30 - 60%少ないトークンです。

✨ 主な機能

• AIコーディングアシスタントにXcodeビルド出力の解析機能を提供
• トークン効率の良い出力形式（TOON）をサポート
• 様々なビルドコマンドの実行と解析結果の自動取得

📦 インストール

前提条件

• Python 3.10以上
• macOS（xcsiftはmacOS専用）
• pipx（brew install pipx でインストール）

ソースからインストール

git clone https://github.com/johnnyclem/xcsift_mcp.git
cd xcsift_mcp
pipx install -e ".[dev]"

Homebrewを使用してインストール

brew install johnnyclem/xcsift-mcp/xcsift-mcp

xcsiftバイナリ

サーバーは初回実行時に、xcsift バイナリがまだインストールされていない場合、GitHubリリースから自動的にダウンロードします。バイナリは ~/.local/share/xcsift-mcp/bin/ にキャッシュされます。

Homebrewを使用して手動でインストールすることもできます。

brew install xcsift

💻 使用例

サーバーの実行

# stdioトランスポートで実行（デフォルト、Claude Desktop/OpenCode用）
xcsift-mcp

# HTTPトランスポートで実行（デバッグ/ウェブクライアント用）
xcsift-mcp --transport http --port 8000

AIアシスタントとの統合

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "xcsift": {
      "command": "xcsift-mcp"
    }
  }
}

OpenCode

opencode.json（または opencode.jsonc）に追加します。

{
  "mcp": {
    "xcsift": {
      "type": "local",
      "command": ["xcsift-mcp"]
    }
  }
}

あるいは、opencode mcp add を実行し、インタラクティブなプロンプトに従います。

Cursor

Cursorの設定のMCP構成に追加するか、.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "xcsift": {
      "command": "xcsift-mcp"
    }
  }
}

利用可能なツール

解析ツール

ビルド実行ツール

ツールのパラメータ

parse_xcodebuild_output

xcodebuild

swift_build

swift_test

基本的な使用法

既存のビルド出力を解析する

# AIアシスタント内で
result = parse_xcodebuild_output(
    output="<raw xcodebuild output>",
    format="toon",  # または "json"
    include_warnings=True
)

ビルドを実行し、解析結果を取得する

result = xcodebuild(
    action="build",
    scheme="MyApp",
    destination="platform=iOS Simulator,name=iPhone 15",
    output_format="json"
)

カバレッジ付きでテストを実行する

result = swift_test(
    enable_code_coverage=True,
    output_format="toon"
)

エラーのみを抽出する

errors = extract_errors(output="<raw xcodebuild output>")
# 返り値: [{"file": "main.swift", "line": 15, "message": "..."}]

高度な使用法

出力形式

JSON形式

標準的な構造化JSON出力です。

{
  "status": "failed",
  "summary": {
    "errors": 1,
    "warnings": 3,
    "failed_tests": 0,
    "linker_errors": 0,
    "build_time": "3.2s"
  },
  "errors": [
    {
      "file": "main.swift",
      "line": 15,
      "message": "use of undeclared identifier 'unknown'"
    }
  ],
  "warnings": [
    {
      "file": "view.swift",
      "line": 20,
      "message": "variable 'temp' was never used",
      "type": "compile"
    }
  ]
}

TOON形式（トークン最適化）

JSONよりも30 - 60%少ないトークンです。

status: failed
summary:
  errors: 1
  warnings: 3
  failed_tests: 0
  linker_errors: 0
  build_time: 3.2s
errors[1]{file,line,message}:
  main.swift,15,"use of undeclared identifier 'unknown'"
warnings[1]{file,line,message,type}:
  view.swift,20,"variable 'temp' was never used","compile"

各形式の使用時期:

• JSON: 出力をプログラムで解析する必要がある場合、または他のツールと統合する場合
• TOON: LLMに送信する場合、トークン使用量とAPIコストを削減するため

利用可能なリソース

利用可能なプロンプト

📚 ドキュメント

開発

テストの実行

pytest

カバレッジ付きでテストを実行する

pytest --cov=xcsift_mcp

コードフォーマット

ruff format .
ruff check .

プロジェクト構造

xcsift_mcp/
├── src/xcsift_mcp/
│   ├── __init__.py           # パッケージの初期化
│   ├── __main__.py           # エントリーポイント
│   ├── server.py             # FastMCPサーバー
│   ├── xcsift_installer.py   # xcsiftの自動ダウンロード
│   ├── resources.py          # MCPリソース
│   ├── prompts.py            # プロンプトテンプレート
│   └── tools/
│       ├── parse.py          # 解析ツール
│       └── build.py          # ビルド実行ツール
├── tests/
│   ├── fixtures/             # サンプルビルド出力
│   └── test_*.py             # テストファイル
├── pyproject.toml
└── README.md

アーキテクチャ

┌─────────────────────────────────────────────────────────────────┐
│                 AI Assistant (Claude, OpenCode, etc.)           │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                     MCP Protocol (stdio/HTTP)                    │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                     xcsift MCP Server (Python)                   │
│  ┌─────────────────┐  ┌──────────────────┐  ┌────────────────┐  │
│  │   Tools (9)     │  │  Resources (4)   │  │  Prompts (6)   │  │
│  │ - parse_output  │  │ - version        │  │ - analyze      │  │
│  │ - xcodebuild    │  │ - config         │  │ - fix_errors   │  │
│  │ - swift_build   │  │ - formats        │  │ - coverage     │  │
│  │ - swift_test    │  │ - help           │  │ - debug        │  │
│  └─────────────────┘  └──────────────────┘  └────────────────┘  │
└─────────────────────────────────────────────────────────────────┘
                                │
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                     xcsift CLI (subprocess)                      │
└─────────────────────────────────────────────────────────────────┘

トラブルシューティング

xcsiftが見つからない場合

xcsiftが自動的にダウンロードできない場合は、手動でインストールします。

brew install xcsift

パーミッション拒否の場合

xcsiftバイナリに実行権限があることを確認します。

chmod +x ~/.local/share/xcsift-mcp/bin/xcsift

ビルドタイムアウトの場合

長いビルドの場合は、タイムアウトパラメータを増やします。

xcodebuild(scheme="MyApp", timeout=1200)  # 20分

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。

クレジット

• xcsift - 実際の解析を行うSwift CLIツール
• MCP Python SDK - モデルコンテキストプロトコルの実装