{"id":26570853,"url":"https://github.com/r-huijts/xcode-mcp-server","last_synced_at":"2025-03-22T22:19:28.478Z","repository":{"id":272758137,"uuid":"917661541","full_name":"r-huijts/xcode-mcp-server","owner":"r-huijts","description":"MCP Server implementation for Xcode integration","archived":false,"fork":false,"pushed_at":"2025-01-16T12:26:01.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-16T13:41:01.518Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/r-huijts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-01-16T12:15:47.000Z","updated_at":"2025-01-16T12:26:02.000Z","dependencies_parsed_at":"2025-01-16T13:41:09.966Z","dependency_job_id":"39e1b982-c6ca-4562-abfa-6e5ab9db6ede","html_url":"https://github.com/r-huijts/xcode-mcp-server","commit_stats":null,"previous_names":["r-huijts/xcode-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-huijts%2Fxcode-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-huijts%2Fxcode-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-huijts%2Fxcode-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-huijts%2Fxcode-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r-huijts","download_url":"https://codeload.github.com/r-huijts/xcode-mcp-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245026599,"owners_count":20549170,"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-22T22:19:18.766Z","updated_at":"2025-03-22T22:19:28.449Z","avatar_url":"https://github.com/r-huijts.png","language":"TypeScript","readme":"# Xcode MCP Server\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"xcode_icon.svg\" width=\"128\" height=\"128\" alt=\"Xcode MCP Server Icon\"\u003e\n\u003c/div\u003e\n\nA Model Context Protocol (MCP) server that brings the power of AI to your Xcode projects. This server acts as a bridge between Claude and your local Xcode development environment, enabling intelligent code assistance, project management, and automated development tasks.\n\n\u003ca href=\"https://glama.ai/mcp/servers/mmxuwmm7sc\"\u003e\u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/mmxuwmm7sc/badge\" alt=\"Xcode Server MCP server\" /\u003e\u003c/a\u003e\n\n## What is Xcode MCP Server?\n\nAt its core, this server follows a client-server architecture where Claude can securely interact with your local Xcode projects:\n\n```mermaid\nflowchart LR\n    subgraph \"Your Computer\"\n        Claude[\"Claude Desktop\"]\n        MCP[\"Xcode MCP Server\"]\n        XP[(\"Xcode Projects\")]\n\n        Claude \u003c--\u003e|\"MCP Protocol\\n(Commands \u0026 Results)\"| MCP\n        MCP \u003c--\u003e|\"Local Access\\n(File \u0026 Build Operations)\"| XP\n    end\n```\n\nThe communication between the Xcode MCP server and your local projects happens entirely on your machine—your code is not exposed to the internet. The Model Context Protocol ensures that Claude can only perform approved operations through well-defined interfaces, giving you a secure way to let AI assist with your development while maintaining complete control.\n\n## Key Features\n\n### 🔍 Intelligent Project Detection\n- Automatically finds and connects to your active Xcode project\n- Supports manual project selection for precise control\n- Maintains workspace context across interactions\n\n### 📁 Smart File Operations\n- Read and analyze Swift, Objective-C, and project configuration files\n- Create and modify source files with proper syntax and imports\n- Intelligent file listing with type filtering and search\n\n### 🛠 Project Management\n- Access project targets, configurations, and schemes\n- Analyze source files for potential issues\n- Execute builds with specific configurations\n- Run and manage test suites\n\n## Getting Started\n\n### Prerequisites\n\nBefore you begin, ensure you have:\n- Node.js (v14 or later)\n- Xcode Command Line Tools\n- TypeScript\n- Claude Desktop with MCP support\n\n### Quick Setup\n\n1. **Install the Server**:\n   ```bash\n   # Clone the repository\n   git clone [repository-url]\n   cd xcode-server\n\n   # Install dependencies\n   npm install\n\n   # Build the project\n   npm run build\n   ```\n\n2. **Configure Claude Desktop**:\n   Add this to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"xcode-server\": {\n         \"command\": \"node\",\n         \"args\": [\n           \"/path/to/xcode-server/build/index.js\"\n         ],\n         \"env\": {\n           \"PROJECTS_BASE_DIR\": \"/path/to/your/xcode/projects\"\n         }\n       }\n     }\n   }\n   ```\n\n   Replace the paths with your actual installation and projects directory.\n\n## Working with the Server\n\nThe server provides a natural interface for Claude to assist with your Xcode development. Here are some ways you can interact:\n\n### Project Navigation\nAsk Claude to:\n- \"Set my Xcode projects directory to `/Users/username/Documents/XcodeProjects`\"\n- \"What's my current active project?\"\n- \"Switch to the MyApp.xcodeproj project\"\n- \"Show me all Swift files in the project\"\n\n### Code Creation \u0026 Modification\nGet help with:\n- \"Create a new view called ProfileView with a preview provider\"\n- \"Add a @Published email property to UserModel.swift\"\n- \"Set up a modern async/await networking layer\"\n- \"Implement Core Data models with SwiftUI bindings\"\n\n### Project Analysis \u0026 Building\nLet Claude assist with:\n- \"Analyze NetworkManager.swift for potential issues\"\n- \"Build the project in Debug configuration\"\n- \"Run the unit tests for the UserModel module\"\n- \"What build schemes are available?\"\n\n## Development and Debugging\n\n### Building the Project\n```bash\nnpm run build\n```\n\n### Running Tests\n```bash\nnpm test\n```\n\n### Troubleshooting\nThe server provides detailed logging through stderr. Common issues and their solutions:\n\n1. **Project Detection Issues**\n   - Verify your projects directory path\n   - Ensure Xcode Command Line Tools are installed\n   - Check file permissions\n\n2. **Build Problems**\n   - Validate Xcode installation\n   - Check project configurations\n   - Review build settings\n\n## Contributing\n\nWe welcome contributions! Whether it's:\n- 🐛 Bug fixes\n- ✨ New features\n- 📚 Documentation improvements\n- 🧪 Additional tests\n\nFeel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","funding_links":[],"categories":["Developer Tools","Development Tools MCP Servers","📚 Projects (1974 total)","Uncategorized","Community Servers","پیاده‌سازی‌های سرور","Task and Project Management","Legend","MCP Servers","Servers","🌐 Web Development","Table of Contents"],"sub_categories":["IDE \u0026 Editors","MCP Servers","Uncategorized","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eDeveloper Tools","💻 Developer Tools","How to Submit","Software Development","Developer Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-huijts%2Fxcode-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr-huijts%2Fxcode-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-huijts%2Fxcode-mcp-server/lists"}