{"_id":"xcode-mcp-server","_rev":"4-ff570f6568ede2f10e97cb87a42fd82c","name":"xcode-mcp-server","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"xcode-mcp-server","version":"1.0.0","keywords":["xcode","mcp","ai","llm","ios","development","claude","modelcontextprotocol"],"author":{"name":"Your Name"},"license":"MIT","_id":"xcode-mcp-server@1.0.0","maintainers":[{"name":"r-huijts","email":"r.huijts@fontys.nl"}],"homepage":"https://github.com/r-huijts/xcode-mcp-server#readme","bugs":{"url":"https://github.com/r-huijts/xcode-mcp-server/issues"},"bin":{"xcode-server":"dist/index.js"},"dist":{"shasum":"c4cb28c5b2426da90dfa074e7c611f53a394a604","tarball":"https://registry.npmjs.org/xcode-mcp-server/-/xcode-mcp-server-1.0.0.tgz","fileCount":4,"integrity":"sha512-am+nzIbypf3+s/wx/TeQfiaP26iQyLbb4/KN/2KgcMMv/PyxTk7NqSSR4GzAxwDz5wsfBUarpuD2T+gNbk5D8Q==","signatures":[{"sig":"MEUCIBNHuKEanvS/2OWEj/ynjhgLp0Kd4z7CHiJ59q7Fkt6TAiEAp10f3hkmnw1O5Y/LEk7iA8cwgsx3O39+c1x/OQPj0O4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34467},"type":"module","engines":{"node":">=16.0.0"},"gitHead":"b71db22223665baca68509d7a6d7d1a442e5aa7b","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","clean":"rm -rf dist","watch":"tsc --watch","prepare":"npm run build","prebuild":"npm run clean","inspector":"npx @modelcontextprotocol/inspector dist/index.js"},"_npmUser":{"name":"r-huijts","email":"r.huijts@fontys.nl"},"repository":{"url":"git+https://github.com/r-huijts/xcode-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"An MCP server for Xcode integration, enabling AI assistants to interact with Xcode projects","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.2","glob":"^11.0.1","dotenv":"^16.4.7","@types/glob":"^8.1.0","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^20.17.28"},"_npmOperationalInternal":{"tmp":"tmp/xcode-mcp-server_1.0.0_1743165510953_0.8034729907173479","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"xcode-mcp-server","version":"1.0.1","keywords":["xcode","mcp","ai","llm","ios","development","claude","modelcontextprotocol"],"author":{"name":"Your Name"},"license":"MIT","_id":"xcode-mcp-server@1.0.1","maintainers":[{"name":"r-huijts","email":"r.huijts@fontys.nl"}],"homepage":"https://github.com/r-huijts/xcode-mcp-server#readme","bugs":{"url":"https://github.com/r-huijts/xcode-mcp-server/issues"},"bin":{"xcode-server":"dist/index.js"},"dist":{"shasum":"351fe78653bf1fe83a63716c63bb2ce3f85f1508","tarball":"https://registry.npmjs.org/xcode-mcp-server/-/xcode-mcp-server-1.0.1.tgz","fileCount":4,"integrity":"sha512-/xzLwCjIEGvU4jxX9f9uzj9jLDQmWhYQfkLkBQgnboZAAoEK5+pQLedOA3xZ8ocqxXKLUO05rapC6fhK7rjZ8w==","signatures":[{"sig":"MEUCIAH0drascB1JTuJZ44lCpxFj5zccBsjNCRL4zdBl6RcBAiEA4Oe9YZp6z9N4Mzu403FWT9K/F7jfrFGU6m/LQDogF94=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34467},"type":"module","engines":{"node":">=16.0.0"},"gitHead":"b71db22223665baca68509d7a6d7d1a442e5aa7b","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","clean":"rm -rf dist","watch":"tsc --watch","prepare":"npm run build","prebuild":"npm run clean","inspector":"npx @modelcontextprotocol/inspector dist/index.js"},"_npmUser":{"name":"r-huijts","email":"r.huijts@fontys.nl"},"repository":{"url":"git+https://github.com/r-huijts/xcode-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"An MCP server for Xcode integration, enabling AI assistants to interact with Xcode projects","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.2","glob":"^11.0.1","dotenv":"^16.4.7","@types/glob":"^8.1.0","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^20.17.28"},"_npmOperationalInternal":{"tmp":"tmp/xcode-mcp-server_1.0.1_1743165718042_0.8038454696647601","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"xcode-mcp-server","version":"1.0.2","keywords":["xcode","mcp","ai","llm","ios","development","claude","modelcontextprotocol"],"author":{"name":"R.Huijts"},"license":"MIT","_id":"xcode-mcp-server@1.0.2","maintainers":[{"name":"r-huijts","email":"r.huijts@fontys.nl"}],"homepage":"https://github.com/r-huijts/xcode-mcp-server#readme","bugs":{"url":"https://github.com/r-huijts/xcode-mcp-server/issues"},"bin":{"xcode-server":"dist/index.js"},"dist":{"shasum":"1549aa8a394f3dd5d2f79422615149d0367007e7","tarball":"https://registry.npmjs.org/xcode-mcp-server/-/xcode-mcp-server-1.0.2.tgz","fileCount":4,"integrity":"sha512-PPwSfZ/O0hTXnKknJ8hW6xOeEuxBYjhU3oMdL/gX/jMaKnaku7JoN6uwwWbBUkdYGUl6dJmk9ko6PK3fE2cPSA==","signatures":[{"sig":"MEUCIQCS+xsuJ+oDRFFwucJFIgtn3s3x1On5RRFuBbvRB4IDeQIgUMXxy8KrinFh5ijJnWngjx/quujOC9RgIeiRHgbaSwE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35119},"type":"module","engines":{"node":">=16.0.0"},"gitHead":"def0cdbe8a03dad98d8bea7a433bce16971f4560","scripts":{"build":"tsc && chmod +x dist/index.js","clean":"rm -rf dist","watch":"tsc --watch","prepare":"npm run build","prebuild":"npm run clean","inspector":"npx @modelcontextprotocol/inspector dist/index.js"},"_npmUser":{"name":"r-huijts","email":"r.huijts@fontys.nl"},"repository":{"url":"git+https://github.com/r-huijts/xcode-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"An MCP server for Xcode integration, enabling AI assistants to interact with Xcode projects","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.2","glob":"^11.0.1","dotenv":"^16.4.5","@types/glob":"^8.1.0","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^20.17.28"},"_npmOperationalInternal":{"tmp":"tmp/xcode-mcp-server_1.0.2_1743271298414_0.6935750751778906","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"xcode-mcp-server","version":"1.0.3","description":"An MCP server for Xcode integration, enabling AI assistants to interact with Xcode projects","type":"module","bin":{"xcode-server":"dist/index.js"},"scripts":{"clean":"rm -rf dist","prebuild":"npm run clean","build":"tsc && chmod +x dist/index.js","prepare":"npm run build","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector dist/index.js"},"keywords":["xcode","mcp","ai","llm","ios","development","claude","modelcontextprotocol"],"author":{"name":"R.Huijts"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/r-huijts/xcode-mcp-server.git"},"bugs":{"url":"https://github.com/r-huijts/xcode-mcp-server/issues"},"homepage":"https://github.com/r-huijts/xcode-mcp-server#readme","engines":{"node":">=16.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.8.0","@types/glob":"^8.1.0","glob":"^11.0.1","zod":"^3.24.2","dotenv":"^16.4.5"},"devDependencies":{"@types/node":"^20.17.28","typescript":"^5.8.2"},"_id":"xcode-mcp-server@1.0.3","gitHead":"63b1122da614243d14b811e4918b7f3548dbb00b","_nodeVersion":"22.12.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-l54hcPiucPD6k8yG2LT7keOii/Qi2zkNnnPpD2H32EbkWR9JcWdZ92kRQJj+8OkJ1NLKN1lV3o+u7oKWyeHhTQ==","shasum":"f6e59f89239000019107194e30781487925f25dd","tarball":"https://registry.npmjs.org/xcode-mcp-server/-/xcode-mcp-server-1.0.3.tgz","fileCount":4,"unpackedSize":37393,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCFe7F+XAo1yeqKHIYtrmICAdpKjlECBDCJnGVLTKaI/AIhAMehajnkPgF96wxSacI89Le6257lL5cp72TEurFQ6sCS"}]},"_npmUser":{"name":"r-huijts","email":"r.huijts@fontys.nl"},"directories":{},"maintainers":[{"name":"r-huijts","email":"r.huijts@fontys.nl"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/xcode-mcp-server_1.0.3_1743272748329_0.1111413433638"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-28T12:38:30.952Z","modified":"2025-03-29T18:25:48.730Z","1.0.0":"2025-03-28T12:38:31.135Z","1.0.1":"2025-03-28T12:41:58.210Z","1.0.2":"2025-03-29T18:01:38.623Z","1.0.3":"2025-03-29T18:25:48.544Z"},"bugs":{"url":"https://github.com/r-huijts/xcode-mcp-server/issues"},"author":{"name":"R.Huijts"},"license":"MIT","homepage":"https://github.com/r-huijts/xcode-mcp-server#readme","keywords":["xcode","mcp","ai","llm","ios","development","claude","modelcontextprotocol"],"repository":{"type":"git","url":"git+https://github.com/r-huijts/xcode-mcp-server.git"},"description":"An MCP server for Xcode integration, enabling AI assistants to interact with Xcode projects","maintainers":[{"name":"r-huijts","email":"r.huijts@fontys.nl"}],"readme":"# Xcode MCP Server\n\n
\n \"Xcode\n
\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\"Xcode\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 <-->|\"MCP Protocol\\n(Commands & Results)\"| MCP\n MCP <-->|\"Local Access\\n(File & 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## Installation\n\nYou can install this server in three ways:\n\n### 1. Using Claude Desktop with NPM Package\n\nUpdate your Claude configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n \"mcpServers\": {\n \"xcode\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"xcode-mcp-server\"\n ],\n \"env\": {\n \"PROJECTS_BASE_DIR\": \"/path/to/your/xcode/projects\"\n }\n }\n }\n}\n```\n\n### 2. Global NPM Installation\n\nInstall the package globally:\n\n```bash\nnpm install -g @modelcontextprotocol/xcode-server\n```\n\nThen update your Claude configuration:\n\n```json\n{\n \"mcpServers\": {\n \"xcode\": {\n \"command\": \"xcode-server\",\n \"env\": {\n \"PROJECTS_BASE_DIR\": \"/path/to/your/xcode/projects\"\n }\n }\n }\n}\n```\n\n### 3. From Source\n\n1. Clone this repository:\n ```bash\n git clone https://github.com/r-huijts/xcode-mcp-server.git\n cd xcode-mcp-server\n ```\n\n2. Install dependencies:\n ```bash\n npm install\n ```\n\n3. Set up environment variables:\n ```bash\n cp .env.example .env\n ```\n Edit `.env` and set `PROJECTS_BASE_DIR` to your Xcode projects directory.\n\n4. Build the project:\n ```bash\n npm run build\n ```\n\nThen update your Claude configuration:\n\n```json\n{\n \"mcpServers\": {\n \"xcode\": {\n \"command\": \"node\",\n \"args\": [\n \"/absolute/path/to/xcode-mcp-server/dist/index.js\"\n ],\n \"env\": {\n \"PROJECTS_BASE_DIR\": \"/path/to/your/xcode/projects\"\n }\n }\n }\n}\n```\n\n> **Note**: Replace `/path/to/your/xcode/projects` with the actual path to your Xcode projects directory.\n\nAfter updating the configuration, restart Claude Desktop for the changes to take effect.\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 & 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 & 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","readmeFilename":"README.md"}