Gives access to iOS project indexes, allowing AI agents to perform intelligent refactoring and code navigation across iOS codebases.
Provides access to macOS project indexes, enabling AI agents to find function references and perform accurate code modifications across macOS applications.
Interfaces with Swift codebases through IndexStoreDB, helping with refactoring tasks by locating all references to functions and their definitions.
Provides access to Xcode's project index through IndexStoreDB, enabling comprehensive code navigation and refactoring by identifying function call sites and definitions.
Xcode Index MCP
Gives Goose/Cursor access to your iOS/macOS project index through the Model Control Protocol (MCP) and IndexStoreDB. This provides exhaustive lists of function call sites to help your agent with refactoring and code navigation.
Example prompt
"Remove myParameter
from the initializer on line 48 of MyViewController.swift
. Use the Xcode Index MCP to ensure all references are updated."
How to use
Install
uv
(Python package manager) and runuv sync
brew install uv cd /path/to/this/repo uv syncBuild the Swift service (Xcode must be installed)
cd swift-service swift buildThis step is required as it provides the interface to Xcode's index.
Install in Agent of your choice
Goose:
Go to settings and add a custom extension. In the modal that pops up, under the
command
field, add this line:uv run /Users/<USERNAME>/Development/xcode-index-mcp/.venv/bin/xcode-index-mcpNote: Replace
<USERNAME>
with your actual system username, or with the correct path xcode-index-mcp on your machine.The rest should look something like this:
Cursor:
Go to
Settings > MCP > Add new global MCP server
. Update mcp.json (typically located in your Cursor configuration directory) to look something like this:{ "mcpServers": { "Xcode Index MCP": { "command": "uv", "args": ["run", "/Users/<USERNAME>/Development/xcode-index-mcp/.venv/bin/xcode-index-mcp"] } } }Note: Replace
<USERNAME>
with your actual system username, or with the correct path xcode-index-mcp on your machine.Claude Code:
Run this command in the terminal to add the mcp to Claude Code
claude mcp add xcode-index-mcp -- uv run /Users/<USERNAME>/Development/xcode-index-mcp/.venv/bin/xcode-index-mcpNote: Replace
<USERNAME>
with your actual system username, or with the correct path xcode-index-mcp on your machine.Update
.gooseHints
,cursorRules
, orCLAUDE.MD
in your project to tell your agent how to use the plugin. Replace the project name with the name of your project as it appears in the derived data folder.Use tool `xcode-index-mcp` if available. Use project name <Your project name here>. The tool can locate call sites of functions, and function definitions from call sites. If you need a filepath to make a request, use `rg` to find the file and `rg -n` to find the line number. Use the absolute path when requesting symbols from a file.For Cursor, you may want to add these instructions in their own rule file - at the time of writing I don't think cursor reads the MCP
instructions
field.
Running tests
To run tests for Swift, cd into swift-service
and run swift test
.
How it works
The tool consists of two main components:
An MCP server in the
src
directory that handles communication with Goose/CursorA Swift service in the
swift-service
directory that interfaces with Xcode's index using Apple'sIndexStoreDB
package
When the MCP server calls 'load_index', the Swift service will look through Xcode's derived data directory for a project file. When found it will attempt to load the project's index. Queries are passed from the MCP server to the index through a subset of the methods provided in IndexStoreDB.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Gives Goose/Cursor access to your iOS/macOS project index through the Model Control Protocol (MCP) and IndexStoreDB. This provides exhaustive lists of function call sites to help your agent with refactoring and code navigation.
Related MCP Servers
- -securityAlicense-qualityA Goose MCP extension providing voice interaction with modern audio visualization, allowing users to communicate with Goose through speech rather than text.Last updated -71MIT License
- -securityAlicense-qualityAn MCP server that enables web searches using a SearxNG instance, allowing MCP-compatible applications like Goose to perform internet searches.Last updated -1GPL 3.0
- AsecurityFlicenseAqualityThis MCP server allows users to create, manage, and serve web applications through Goose, storing apps in configurable directories and providing web app serving capabilities.Last updated -92
- -securityAlicense-qualityAn MCP server that enables interaction with Kubernetes resources through natural language interfaces like Goose CLI, allowing users to get, read, and patch Kubernetes resources.Last updated -Apache 2.0