Swiftmcp

🚀 SwiftMCP

SwiftMCP 是一個用 Swift 實現的模型上下文協議（Model Context Protocol, MCP）項目，主要用於 AI 代理之間的交互。它能讓 AI 代理通過標準協議與 Swift 應用程序進行高效溝通。

🚀 快速開始

安裝步驟

1. 克隆倉庫：

git clone <repo>
cd SwiftMCP

2. 編譯項目：

swift build

服務器端快速入門

1. 編譯服務器：

swift build --product SwiftMCPServer

2. 運行服務器：

swift run SwiftMCPServer

客戶端端快速入門

1. 編譯客戶端：

swift build --product SwiftMCPClient

2. 運行客戶端：

swift run SwiftMCPClient

✨ 主要特性

• 支持 Swift 6.1 或更高版本
• 適用於 iOS 18.0+ / macOS 15.0+
• 使用 Xcode 15.0+
• 服務器端：使用 Swift 6.1 開發，在標準 I/O 上實現 MCP 協議，支持日誌、提示、資源和工具，針對 iOS 18+ 和 macOS 15+ 設計
• 客戶端：使用 Swift 6.1 開發，在標準 I/O 上實現 MCP 客戶端，針對 iOS 18+ 和 macOS 15+ 設計，提供簡單易用的 API，用於初始化和與 MCP 服務器通信

📦 安裝指南

克隆倉庫

git clone <repo>
cd SwiftMCP

編譯項目

swift build

📚 詳細文檔

項目結構

該項目分為兩大主要部分：

• SwiftMCPServer：服務器實現組件
• SwiftMCPClient：客戶端實現組件

依賴項

• MCP Swift SDK

服務器端

SwiftMCP 的服務器組件提供了一個基於 Swift 實現的 Model Context Protocol 服務器。它使 AI 代理能夠通過標準協議與 Swift 應用程序進行交互。

功能特性

• 使用 Swift 6.1 開發
• 在標準 I/O 上實現 MCP 協議
• 支持日誌、提示、資源和工具
• 針對 iOS 18+ 和 macOS 15+ 設計

服務器組件細節

服務器組件 (SwiftMCPServer) 負責：

• 處理 MCP 的進站連接
• 管理模型上下文
• 處理客戶端請求
• 維護狀態同步

位置：SwiftMCPServer/Sources

客戶端端

SwiftMCP 的客戶端組件允許 Swift 應用程序連接到並與支持 MCP 的 AI 代理進行交互。

功能特性

• 使用 Swift 6.1 開發
• 在標準 I/O 上實現 MCP 客戶端
• 針對 iOS 18+ 和 macOS 15+ 設計
• 提供簡單易用的 API，用於初始化和與 MCP 服務器通信

客戶端組件細節

客戶端組件 (SwiftMCPClient) 提供：

• 對 MCP 服務器的連接管理
• 模型上下文同步
• 即時更新處理
• 客戶端狀態管理

位置：SwiftMCPClient/Sources