modelcontextprotocol/swift-sdk

解决的问题

模型上下文协议 (MCP) 标准化了应用程序与 AI 模型之间的通信方式。此 SDK 为 Swift 开发者提供了官方构建模块，用于创建客户端（连接到 MCP 服务器的应用程序）和服务器（向客户端公开功能的应用程序）。如果没有它，开发者将不得不从零开始实现该协议。

工作原理

该 SDK 包含一个用于通过 stdio 或 HTTP 传输连接到 MCP 服务器的 Client 类，以及一个用于托管功能的 Server 类。两者都支持核心 MCP 功能：工具、资源、提示词、补全、采样（服务器到客户端的 LLM 请求）、引导（服务器到客户端的用户输入请求）、根目录（文件系统边界）、日志记录和进度更新。客户端支持严格或非严格的功能检查、请求批处理和取消。服务器包括优雅关闭和 HTTP 请求上下文处理。

适用人群

需要通过 MCP 与 AI/ML 模型交互，或创建 MCP 服务器以公开工具、数据和提示词的 Swift 开发者。需要 Swift 6.0+ (Xcode 16+)。

亮点

• 与最新 MCP 规范 (2025-11-25) 对齐的官方 SDK。
• 在一个包中同时包含客户端和服务器实现。
• 支持多种传输方式：用于本地子进程的 stdio 和用于远程通信的流式 HTTP。
• 全面的客户端功能：工具、资源、提示词、补全、采样、引导、根目录、日志记录、取消、进度跟踪、批处理和身份验证流程。
• 服务器功能：具备相同功能，外加初始化钩子、HTTP 请求上下文、优雅关闭。
• 通过 Swift Package Manager 轻松集成。