SwiftMCP

SwiftMCP is a Swift-based implementation of the Model Context Protocol (MCP) that provides a server component for AI agents to interact with Swift applications using MCP. The server communicates over standard I/O and leverages the MCP Swift SDK to manage model context, prompts, resources, and tools. To use it, first build the project and then run the SwiftMCPServer binary. The server exposes MCP-compliant endpoints and maintains state synchronization with connected clients, enabling real-time updates and resource/tool management as agents interact with your Swift application.

Once running, you can connect an MCP client to the server and begin a session where the agent can request model context, access resources, use available tools, and receive updates in real time. The server is designed to work with the MCP protocol over standard I/O, making it suitable for embedding in CLI workflows, quick experiments, or integration tests with Swift-based agents.

Prerequisites:

• Swift 6.2+ (Xcode 14+ or later, depending on your OS)
• macOS 13+ / iOS 26+ compatible environments

Installation steps:

1. Clone the repository:

git clone <repo>
cd SwiftMCP

2. Install dependencies and build the project:

swift build

3. Build a specific server binary (server):

swift build --product SwiftMCPServer

4. Run the server:

swift run SwiftMCPServer

5. If you also need the client component, build and run it similarly:

swift build --product SwiftMCPClient
swift run SwiftMCPClient

Notes:

• The project is organized into two components: SwiftMCPServer and SwiftMCPClient, located under SwiftMCPServer/Sources and SwiftMCPClient/Sources respectively.
• This server relies on the MCP Swift SDK for protocol implementation and interaction with agents.
• Ensure you are using a Swift toolchain compatible with Swift 6.2+ for builds and runs.
• If you encounter build errors related to dependencies, run swift package update and then swift build again.
• Environment variables are not strictly required for a basic run, but you may expose MCP-related configs (e.g., log level, resource paths) through environment variables or additional configuration files as needed by your deployment.
• The mcp_config assumes a SwiftMCPServer binary is available via Swift Package Manager; adjust the command if you package the server differently.