xc-mcp/dist/registry/xcodebuild.js

MCP server that wraps Xcode command-line tools for iOS/macOS development workflows

import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
import { z } from 'zod';
import { validateXcodeInstallation } from '../utils/validation.js';
import { getDescription } from './types.js';
import { xcodebuildVersionTool, XCODEBUILD_VERSION_DOCS, XCODEBUILD_VERSION_DOCS_MINI, } from '../tools/xcodebuild/version.js';
import { xcodebuildListTool, XCODEBUILD_LIST_DOCS, XCODEBUILD_LIST_DOCS_MINI, } from '../tools/xcodebuild/list.js';
import { xcodebuildBuildTool, XCODEBUILD_BUILD_DOCS, XCODEBUILD_BUILD_DOCS_MINI, } from '../tools/xcodebuild/build.js';
import { xcodebuildCleanTool, XCODEBUILD_CLEAN_DOCS, XCODEBUILD_CLEAN_DOCS_MINI, } from '../tools/xcodebuild/clean.js';
import { xcodebuildTestTool, XCODEBUILD_TEST_DOCS, XCODEBUILD_TEST_DOCS_MINI, } from '../tools/xcodebuild/xcodebuild-test.js';
import { xcodebuildGetDetailsTool, XCODEBUILD_GET_DETAILS_DOCS, XCODEBUILD_GET_DETAILS_DOCS_MINI, } from '../tools/xcodebuild/get-details.js';
const ENABLE_DEFER_LOADING = process.env.XC_MCP_DEFER_LOADING !== 'false';
const DEFER_LOADING_CONFIG = ENABLE_DEFER_LOADING
    ? { defer_loading: true }
    : {};
export function registerXcodebuildTools(server) {
    // xcodebuild-version
    server.registerTool('xcodebuild-version', {
        description: getDescription(XCODEBUILD_VERSION_DOCS, XCODEBUILD_VERSION_DOCS_MINI),
        inputSchema: {
            sdk: z.string().optional(),
            outputFormat: z.enum(['json', 'text']).default('json'),
        },
        ...DEFER_LOADING_CONFIG,
    }, async (args) => {
        try {
            await validateXcodeInstallation();
            return await xcodebuildVersionTool(args);
        }
        catch (error) {
            if (error instanceof McpError)
                throw error;
            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
        }
    });
    // xcodebuild-list
    server.registerTool('xcodebuild-list', {
        description: getDescription(XCODEBUILD_LIST_DOCS, XCODEBUILD_LIST_DOCS_MINI),
        inputSchema: {
            projectPath: z.string(),
            outputFormat: z.enum(['json', 'text']).default('json'),
        },
        ...DEFER_LOADING_CONFIG,
    }, async (args) => {
        try {
            await validateXcodeInstallation();
            return await xcodebuildListTool(args);
        }
        catch (error) {
            if (error instanceof McpError)
                throw error;
            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
        }
    });
    // xcodebuild-build
    server.registerTool('xcodebuild-build', {
        description: getDescription(XCODEBUILD_BUILD_DOCS, XCODEBUILD_BUILD_DOCS_MINI),
        inputSchema: {
            projectPath: z.string(),
            scheme: z.string(),
            configuration: z.string().default('Debug'),
            destination: z.string().optional(),
            sdk: z.string().optional(),
            derivedDataPath: z.string().optional(),
        },
        ...DEFER_LOADING_CONFIG,
    }, async (args) => {
        try {
            await validateXcodeInstallation();
            return await xcodebuildBuildTool(args);
        }
        catch (error) {
            if (error instanceof McpError)
                throw error;
            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
        }
    });
    // xcodebuild-clean
    server.registerTool('xcodebuild-clean', {
        description: getDescription(XCODEBUILD_CLEAN_DOCS, XCODEBUILD_CLEAN_DOCS_MINI),
        inputSchema: {
            projectPath: z.string(),
            scheme: z.string(),
            configuration: z.string().optional(),
        },
        ...DEFER_LOADING_CONFIG,
    }, async (args) => {
        try {
            await validateXcodeInstallation();
            return await xcodebuildCleanTool(args);
        }
        catch (error) {
            if (error instanceof McpError)
                throw error;
            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
        }
    });
    // xcodebuild-test
    server.registerTool('xcodebuild-test', {
        description: getDescription(XCODEBUILD_TEST_DOCS, XCODEBUILD_TEST_DOCS_MINI),
        inputSchema: {
            projectPath: z.string(),
            scheme: z.string(),
            configuration: z.string().default('Debug'),
            destination: z.string().optional(),
            sdk: z.string().optional(),
            derivedDataPath: z.string().optional(),
            testPlan: z.string().optional(),
            onlyTesting: z.array(z.string()).optional(),
            skipTesting: z.array(z.string()).optional(),
            testWithoutBuilding: z.boolean().default(false),
        },
        ...DEFER_LOADING_CONFIG,
    }, async (args) => {
        try {
            await validateXcodeInstallation();
            return await xcodebuildTestTool(args);
        }
        catch (error) {
            if (error instanceof McpError)
                throw error;
            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
        }
    });
    // xcodebuild-get-details
    server.registerTool('xcodebuild-get-details', {
        description: getDescription(XCODEBUILD_GET_DETAILS_DOCS, XCODEBUILD_GET_DETAILS_DOCS_MINI),
        inputSchema: {
            buildId: z.string(),
            detailType: z.enum([
                'full-log',
                'errors-only',
                'warnings-only',
                'summary',
                'command',
                'metadata',
            ]),
            maxLines: z.number().default(100),
        },
        ...DEFER_LOADING_CONFIG,
    }, async (args) => {
        try {
            await validateXcodeInstallation();
            return await xcodebuildGetDetailsTool(args);
        }
        catch (error) {
            if (error instanceof McpError)
                throw error;
            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
        }
    });
}
//# sourceMappingURL=xcodebuild.js.map