{"id":26718567,"url":"https://github.com/devyhan/xcode-mcp","last_synced_at":"2025-03-27T17:35:09.750Z","repository":{"id":284694870,"uuid":"955759218","full_name":"devyhan/xcode-mcp","owner":"devyhan","description":"Xcode CLI 명령어를 실행하고 MCP(Model Context Protocol)를 통해 AI 시스템과 상호작용할 수 있는 서버","archived":false,"fork":false,"pushed_at":"2025-03-27T07:09:08.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T07:33:41.807Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devyhan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-27T06:38:10.000Z","updated_at":"2025-03-27T07:09:11.000Z","dependencies_parsed_at":"2025-03-27T07:33:47.436Z","dependency_job_id":"7923f20d-bc6e-4766-9669-e81880f8f8e9","html_url":"https://github.com/devyhan/xcode-mcp","commit_stats":null,"previous_names":["devyhan/xcode-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devyhan%2Fxcode-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devyhan%2Fxcode-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devyhan%2Fxcode-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devyhan%2Fxcode-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devyhan","download_url":"https://codeload.github.com/devyhan/xcode-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245876583,"owners_count":20687181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-27T17:35:09.164Z","updated_at":"2025-03-27T17:35:09.742Z","avatar_url":"https://github.com/devyhan.png","language":"TypeScript","readme":"# @devyhan/xcode-mcp\n\nAn MCP (Model Context Protocol) server that allows you to execute shell commands from MCP clients, with special tools for Xcode-related operations.\n\n## Installation\n\n```bash\nnpm install @devyhan/xcode-mcp\n```\n\n## Usage\n\n### Using with Claude Desktop\n\n1. Open Claude Desktop config file:\n   ```bash\n   # macOS\n   open ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n   ```\n\n2. Add or modify the following configuration:\n   ```json\n   {\n     \"mcpServers\": {\n       \"xcode-mcp\": {\n         \"command\": \"npx\",\n         \"args\": [\n           \"@devyhan/xcode-mcp\",\n           \"-y\"\n         ]\n       }\n     }\n   }\n   ```\n\n3. Restart Claude Desktop.\n\n### Available Tools\n\n#### 1. execute-shell\n\nExecutes shell commands and returns the results.\n\n**Parameters**:\n- `command` (required): The shell command to execute\n- `workingDir` (optional): Working directory where the command will be executed\n- `timeout` (optional): Command execution timeout in milliseconds, default: 60000ms\n\n**Example**:\n```\nCommand: ls -la\n```\n\n#### 2. xcode-project-info\n\nRetrieves information about an Xcode project.\n\n**Parameters**:\n- `projectPath` (required): Path to the Xcode project or workspace\n\n**Example**:\n```\nProject path: /Users/username/Projects/MyApp/MyApp.xcodeproj\n```\n\n#### 3. xcode-build\n\nBuilds an Xcode project.\n\n**Parameters**:\n- `projectPath` (required): Path to the Xcode project or workspace\n- `scheme` (required): The scheme to build\n- `configuration` (optional): Build configuration (e.g., Debug, Release)\n- `destination` (optional): Build destination (e.g., 'platform=iOS Simulator,name=iPhone 14')\n\n**Example**:\n```\nProject path: /Users/username/Projects/MyApp/MyApp.xcodeproj\nScheme: MyAppScheme\nConfiguration: Debug\nDestination: platform=iOS Simulator,name=iPhone 14\n```\n\n### Example Scenario: Using with LLMs\n\nBelow is an example of how you might prompt an LLM like Claude to use these tools in sequence:\n\n**User Prompt to Claude:**\n```\nI need to inspect my Xcode project and then build it.\n\n1. First, use the xcode-project-info tool to get information about my project at /Users/username/Projects/MyApp/MyApp.xcodeproj\n2. After you see the project info, identify the available schemes from the output.\n3. Then use the xcode-build tool to build my project with the first available scheme, using the Debug configuration and targeting the iOS Simulator.\n```\n\n**Expected Workflow:**\n1. Claude will execute the `xcode-project-info` tool to retrieve the project information\n2. Claude will analyze the output to identify available schemes\n3. Claude will then use the `xcode-build` tool with parameters filled from the information it discovered:\n   ```\n   Project path: /Users/username/Projects/MyApp/MyApp.xcodeproj\n   Scheme: [First scheme from project info]\n   Configuration: Debug\n   Destination: platform=iOS Simulator,name=iPhone 14\n   ```\n\nThis workflow demonstrates how to chain multiple tools together, using the output from one tool to inform the parameters for another.\n\n## Security Considerations\n\nThis tool can execute shell commands, which poses security risks. Please note:\n\n- Only execute commands you trust.\n- Commands that could damage your system (`rm -rf /`, `mkfs`, etc.) are blocked for security reasons.\n- Do not execute commands containing sensitive information.\n\n## Development\n\n### Requirements\n\n- Node.js 16 or higher\n- npm 6 or higher\n\n### Local Development and Testing\n\n```bash\n# Clone the repository\ngit clone https://github.com/devyhan/xcode-mcp.git\ncd xcode-mcp\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build\nnpm run build\n\n# Test\nnpm test\n```\n\n## License\n\nMIT\n","funding_links":[],"categories":["Command Line","Content Creation"],"sub_categories":["How to Submit"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevyhan%2Fxcode-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevyhan%2Fxcode-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevyhan%2Fxcode-mcp/lists"}