[codex] Add minimal Xcode Cloud MCP server

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+---
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test
+    runs-on: [self-hosted, macOS]
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v6
+        with:
+          clean: true
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Run Tests
+        run: npm test

.github/workflows/nightly.yml

@@ -0,0 +1,32 @@
+---
+name: Nightly Tests
+
+on:
+  schedule:
+    - cron: '0 4 * * *'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  nightly_tests:
+    name: Nightly Tests
+    runs-on: [self-hosted, macOS]
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v6
+        with:
+          clean: true
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Run Tests
+        run: npm test

.gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+.env
+.DS_Store
+coverage

README.md

@@ -1,2 +1,112 @@
+<p align="center">
+  <a href="https://docs.anthropic.com/en/docs/claude-code/mcp"><img alt="Claude" src="https://img.shields.io/badge/Claude-MCP-D97757.svg?logo=claude&logoColor=white"></a>
+  <a href="https://developers.openai.com/codex/mcp"><img alt="Codex" src="https://img.shields.io/badge/Codex-MCP-1F70C1.svg?logo=icloud&logoColor=white"></a>
+  <a href="https://en.wikipedia.org/wiki/MIT_License"><img alt="License" src="https://img.shields.io/badge/License-MIT-67ac5b.svg?logo=googledocs&logoColor=white"></a>
+  <a href="https://github.com/thatfactory/xcode-cloud-mcp/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/thatfactory/xcode-cloud-mcp/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/thatfactory/xcode-cloud-mcp/actions/workflows/nightly.yml"><img alt="Nightly" src="https://github.com/thatfactory/xcode-cloud-mcp/actions/workflows/nightly.yml/badge.svg"></a>
+</p>
+
 # xcode-cloud-mcp
-MCP server for working with Apple's Xcode Cloud. ☁️
+
+Minimal MCP server for discovering Xcode Cloud products and workflows, then retrieving build issues, logs, test summaries, and UI test artifacts through the App Store Connect API.
+
+## Features
+
+- Discover Xcode Cloud products with `list_products`.
+- Discover workflows for a product with `list_workflows`.
+- List recent workflow runs with `list_build_runs`.
+- Retrieve build issue counts with `get_build_issues`.
+- Retrieve and summarize text-like build logs with `get_build_logs`.
+- Retrieve test summaries with `get_test_results`.
+- Retrieve screenshots, videos, result bundles, and test products with `get_test_artifacts`.
+
+Build lookup is workflow-scoped. Retrieval tools accept a direct `buildRunId`, or a `workflowId` plus `buildNumber`, or a `workflowId` plus `buildSelector: "latest" | "latestFailing"`.
+
+## Requirements
+
+- Node.js `20+`
+- App Store Connect API credentials with access to Xcode Cloud
+
+## Environment Variables
+
+Primary names:
+
+- `APPSTORE_CONNECT_API_KEY_ID`
+- `APPSTORE_CONNECT_API_ISSUER_ID`
+- `APPSTORE_CONNECT_API_KEY_CONTENT`
+
+Compatibility aliases:
+
+- `APP_STORE_KEY_ID`
+- `APP_STORE_ISSUER_ID`
+- `APP_STORE_PRIVATE_KEY`
+
+The private key can be passed as literal multi-line PEM content or as a string with escaped `\n`.
+
+## Claude Setup
+
+```bash
+claude mcp add xcode-cloud \
+  --env APPSTORE_CONNECT_API_KEY_ID="$APPSTORE_CONNECT_API_KEY_ID" \
+  --env APPSTORE_CONNECT_API_ISSUER_ID="$APPSTORE_CONNECT_API_ISSUER_ID" \
+  --env APPSTORE_CONNECT_API_KEY_CONTENT="$APPSTORE_CONNECT_API_KEY_CONTENT" \
+  -- npx -y @thatfactory/xcode-cloud-mcp
+```
+
+## Codex Setup
+
+```bash
+codex mcp add xcode-cloud \
+  --env APPSTORE_CONNECT_API_KEY_ID="$APPSTORE_CONNECT_API_KEY_ID" \
+  --env APPSTORE_CONNECT_API_ISSUER_ID="$APPSTORE_CONNECT_API_ISSUER_ID" \
+  --env APPSTORE_CONNECT_API_KEY_CONTENT="$APPSTORE_CONNECT_API_KEY_CONTENT" \
+  -- npx -y @thatfactory/xcode-cloud-mcp
+```
+
+## Available Tools
+
+- `list_products(limit?)`
+- `list_workflows(productId, limit?)`
+- `list_build_runs(workflowId, limit?, status?)`
+- `get_build_issues(buildRunId? workflowId? buildNumber? buildSelector?)`
+- `get_build_logs(buildRunId? workflowId? buildNumber? buildSelector?, maxCharacters?)`
+- `get_test_results(buildRunId? workflowId? buildNumber? buildSelector?)`
+- `get_test_artifacts(buildRunId? workflowId? buildNumber? buildSelector?)`
+
+## Example Prompts
+
+```text
+Retrieve logs of the latest failing build for workflow abc123.
+```
+
+```text
+Retrieve logs of build number 42 for workflow abc123.
+```
+
+```text
+Show me the latest failing UI test artifacts for workflow abc123.
+```
+
+```text
+List the workflows for product def456 and then summarize the latest build.
+```
+
+## Local Development
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Run tests:
+
+```bash
+npm test
+```
+
+Build the package:
+
+```bash
+npm run build
+```