Search SPM Dependencies in Xcode Projects with MCP Tool

Spm Dependencies MCP

An MCP server for searching and exploring Swift package dependencies in Xcode and SPM projects, helping coding agents access hidden dependency code files.

Developer tools Search tools #Swift Package Management #Dependency Search #Code Exploration .Rust

rating : 2 points

downloads : 3.2K

update time : 2025-12-29

Open Site

What is the SPM Dependencies MCP Server?

This is an MCP server specifically designed for Swift development projects. When you use third - party libraries in Xcode or Swift Package Manager projects, the code of these dependencies is usually downloaded to hidden system directories (such as DerivedData), which cannot be directly accessed by AI assistants and coding agents. This server provides specialized tools that allow AI to search, browse, and read the code of these dependencies, thereby better understanding and assisting your development work.

How to use the SPM Dependencies MCP Server?

You need to configure this server in an AI assistant that supports the MCP protocol (such as Claude Desktop). After configuration, the AI assistant can use the provided tools to explore the dependencies of your Swift project. The server provides four main tools: list all dependencies, search dependency code, list dependency files, and read specific files.

Use Cases

1. When an AI assistant needs to understand the implementation details of third - party libraries used in your project. 2. When debugging, you need to view the source code of the dependency library. 3. When learning the implementation method of third - party libraries. 4. When checking the dependency version and file structure. 5. When searching for specific functions or API usages in the dependency code.

Main Features

View Dependency List

List all Swift package dependencies used in the project, showing the version information of each dependency and its specific location on the disk. It helps you understand the dependency structure and version status of the project.

Full - text Code Search

Use ripgrep to perform powerful full - text searches in the dependency code. It supports all ripgrep parameters and can search for code according to various conditions such as patterns, file types, and contexts.

File Browsing

Browse the file structure in the dependency package and view the organization method of the dependency package. You can view all files by directory hierarchy to understand the architectural design of the dependency package.

Read File Content

Read the content of a specific file in the dependency package. Use the sed tool, which supports various text processing parameters, allowing you to flexibly view and extract file content.

Direct Command - Line Access

In addition to accessing through the MCP server, all tools can also be used directly through the command line, which is convenient for developers to quickly operate in the terminal.

Advantages

Solve the problem that AI assistants cannot access hidden dependency code

Provide a unified interface to access all SPM dependencies

Support powerful search functions (ripgrep)

Dual access methods: command - line and MCP

Lightweight, easy to configure and use

Open - source and extensible

Limitations

Only support Swift Package Manager projects

Require the project to have resolved dependencies (exist in DerivedData)

Search performance is affected by the size of the dependency package

Require MCP client support to be configured

Only support macOS and Linux systems

How to Use

Install the Server

Ensure that your system has Node.js and npm installed. The server can be run directly via npx without global installation.

Configure the MCP Client

Add the server configuration to the configuration file of an AI assistant that supports MCP (such as Claude Desktop). You need to specify to run the server using the npx command.

Start the AI Assistant

Restart your AI assistant application to ensure that the MCP server configuration takes effect. The AI assistant can now access the SPM dependency tools.

Use the Tools

Use the provided tools through the AI assistant interface: list dependencies, search code, browse files, and read file content.

Usage Examples

Understand the Project Dependency Structure

When an AI assistant needs to understand the overall dependency situation of your project, it can quickly list all dependencies and their versions, helping to understand the project's technology stack.

Search for Implementations in the Dependency Library

When you want to understand how a certain function is implemented in the dependency library or need to find the usage of a specific API, you can search in the dependency code.

View the Content of Dependency Files

When you need to view the specific implementation file of a dependency library, you can directly read the file content for analysis.

Debug Dependency Issues

When encountering problems related to the dependency library, you can quickly browse the dependency file structure to find possible configuration or implementation issues.