本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
Swift
在 macOS 應用程式中內嵌 StackQL MCP 伺服器。已簽署且經過公證的二進位檔可以打包到您的 .app 中,用戶端則是官方的 Swift MCP SDK。
內嵌的二進位檔會在首次執行時下載並經過 sha256 驗證,或透過 vendoring 納入您的應用程式。請參閱共同契約。
安裝
將套件加入您的 Package.swift:
.package(url: "https://github.com/stackql/stackql-mcp-swift.git", from: "0.1.0")
需要 macOS 13+ 與 Swift 6.1(Xcode 16.3+)。唯一的相依套件是官方的 Swift MCP SDK。
快速入門
import StackQLMCP
var options = Options()
options.mode = .readOnly
options.auth = ["github": ["type": "null_auth"]]
let server = try await StackQLServer.start(options)
let tools = try await server.listToolNames()
print("\(tools.count) tools available")
let services = try await server.call(
"list_services", ["provider": "github", "row_limit": 5])
print(services.text)
await server.stop()
API 包括 StackQLServer.start(Options)、.listToolNames()、.call(_:_:) 與 .stop()。Options 包含 mode、auth、binaryOverride 與 allowDownload。對於外部執行框架,StackQLServer.resolveCommand(_:) 會傳回解析後的啟動命令。
模式
Options.mode 預設為 .readOnly。若要提升權限,請將其設為 .safe、.deleteSafe 或 .fullAccess。權限提升必須明確指定:除非您選擇加入,否則伺服器不會啟用變更或生命週期工具。
Vendoring / 內嵌
darwin-universal 二進位檔已使用 Developer ID 簽署並經過 Apple 公證,因此可以打包到已簽署的 macOS .app 中,同時讓應用程式本身的公證保持有效。這是 Swift 程式庫獨有的功能:您發行的是單一、獨立且經過公證的應用程式,首次執行時不需要下載。
二進位檔解析順序:
- 明確指定的
binaryOverride。 - 打包在
.app中的資源。 - 位於
~/.stackql/mcp-server-bin/的共用快取。 - 下載並進行 sha256 驗證(設定
allowDownload時)。
示範應用程式
CloudLens 是一個選單列雲端哨兵,內嵌經過公證的二進位檔,並執行一組 read_only 檢查。