翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何在 macOS Swift 應用程式中內嵌 StackQL MCP 伺服器
StackQL 的 MCP 伺服器可以在原生 macOS 應用程式內執行,無需另外安裝,也沒有執行階段相依性。stackql-mcp-swift 套件會在官方 Swift MCP SDK 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔。由於 darwin-universal 二進位檔以 Developer ID 簽署並經過 Apple 公證,您可以將它封裝在已簽署的 .app 中,並維持應用程式的公證有效。這正是 CloudLens 背後的模式,它是一個選單列雲端哨兵。
步驟
- 新增套件至
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。
- 啟動伺服器並呼叫工具。
Options.mode預設為.readOnly:
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()
對於外部執行框架,StackQLServer.resolveCommand(_:) 會傳回解析後的啟動命令。
- 選擇模式。
Options.mode預設為.readOnly。只有在應用程式需要佈建時,才設定.safe、.deleteSafe或.fullAccess。權限提升需明確指定。
將經過公證的二進位檔封裝在已簽署的應用程式中
darwin-universal 二進位檔以 Developer ID 簽署並經過 Apple 公證,因此可以封裝在已簽署的 macOS .app 中,同時維持應用程式本身的公證有效。二進位檔解析順序:
- 明確指定的
binaryOverride。 - 封裝在
.app中的資源。 - 位於
~/.stackql/mcp-server-bin/的共用快取。 - 下載並進行 sha256 驗證(設定
allowDownload時)。
將經過公證的二進位檔放入應用程式資源,就會優先使用封裝的路徑,讓應用程式完全獨立,首次執行時不需下載。
示範應用程式
CloudLens 是一個選單列雲端哨兵,它內嵌經過公證的二進位檔,並執行一系列 read_only 檢查。
相關概念
- 內嵌式 MCP:Swift 參考:安裝、API 與二進位檔解析
- 如何搭配 AI 代理程式使用 StackQL:MCP 模型與安全模式
- StackQL MCP 架構:傳輸方式、模式與稽核內部機制
- 什麼是代理式基礎架構?:此做法促成的模式