SwiftMCP for iOS and macOS

Overview

SwiftMCP is a Swift Package that implements an MCP (Model Context Protocol) client for iOS and macOS, enabling native API integration through a JSON-RPC interface. The package also includes an OpenAI-compatible function calling bridge.

Features

• Open source function definitions for Apple's native APIs like HealthKit
• JSON-RPC 2.0 compliant interface
• Some test coverage

Requirements

• iOS 15.0+ / macOS 12.0+
• Swift 6.0+
• Xcode 15.0+

Installation

Swift Package Manager

Add the following dependency to your Package.swift file:

dependencies: [
    .package(url: "https://github.com/compiler-inc/SwiftMCP.git", from: "1.0.0")
]

Architecture

[![Architecture Diagram](https://camo.githubusercontent.com/82180cfd60f0fcb28ae72e1406352f45d886b045322aac4379c07305411a3e03/68747470733a2f2f6d65726d6169642e696e6b2f696d672f70616b6f3a654e71465645317a6d7a41555f437361585774376a4250416347676d7858576e6e58486969584e4a775163566e6d306d49464639744846745f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586b475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486b33654d304e4b76706a75477431393474577172356a4c743767416534424a306e7a5f5164505a68796775554f536b6877714745474736494b6157374253564f4a6b6d793170796b4f4a566377774a7970375136484731494950564e565269544d63714a7655396c564b304a5f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586b475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486b33654d304e4b76706a75477431393474577172356a4c743767416534424a306e7a5f5164505a68796775554f536b6877714745474736494b6157374253564f4a6b6d793170796b4f4a566377774a7970375136484731494950564e565269544d63714a7655396c564b304a5f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586k475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486b33654d304e4b76706a75477431393474577172356a4c743767416534424a306e7a5f5164505a68796775554f536b6877714745474736494b6157374253564f4a6b6d793170796b4f4a566377774a7970375136484731494950564e565269544d63714a7655396c564b304a5f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586k475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486b33654d304e4b76706a75477431393474577172356a4c743767416534424a306e7a5f5164505a68796775554f536b6877714745474736494b6157374253564f4a6b6d793170796b4f4a566377774a7970375136484731494950564e565269544d63714a7655396c564b304a5f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586k475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486b33654d304e4b76706a75477431393474577172356a4c743767416534424a306e7a5f5164505a68796775554f536b6877714745474736494b6157374253564f4a6b6d793170796b4f4a566377774a7970375136484731494950564e565269544d63714a7655396c564b304a5f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586k475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486b33654d304e4b76706a75477431393474577172356a4c743767416534424a306e7a5f5164505a68796775554f536b6877714745474736494b6157374253564f4a6b6d793170796b4f4a566377774a7970375136484731494950564e565269544d63714a7655396c564b304a5f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586k475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486b33654d304e4b76706a75477431393474577172356a4c743767416534424a306e7a5f5164505a68796775554f536b6877714745474736494b6157374253564f4a6b6d793170796b4f4a566377774a7970375136484731494950564e565269544d63714a7655396c564b304a5f5f644b34734e4d6e45793461505730753971484541656373677877694463462d357675434a666f635a5a5170422d68666d30357158596f77537551716b7077585466506256553538524e54334b41314767345f6f776659356b4c7966667a49574e464f316d644a5732724a6869626975676f6332576c444235725634434a49784f676634494c496e46453031354666685a7138436e566641623339726a654a615f524f746f356d526439417a6d416a596a30324b7a596430735763356d5a7230644d32624b74633665524c7a73704b7867616947714e5046336f6b57575064637a7172725a6e52524b516f446b324742586k475554755a387333707244796a566d51636a6e6673694f59354a62706c5563555749514e314146685f7148344363555431433564784d3572635031623364384f485a6153746669735173756655736b7a385262534d6968796f6a44765559335931795f333641716e5a4f7a5a415362424265757832765457325f6569786e2d576972595a6e4e553077712d7531306a5f643167484e47535f4a473131315a756163767044307554376a475a486