跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

如何在 macOS Swift 應用程式中內嵌 StackQL MCP 伺服器

StackQL 的 MCP 伺服器可以在原生 macOS 應用程式內執行,無需另外安裝,也沒有執行階段相依性。stackql-mcp-swift 套件會在官方 Swift MCP SDK 用戶端背後,透過 stdio 啟動已簽署的 StackQL 二進位檔。由於 darwin-universal 二進位檔以 Developer ID 簽署並經過 Apple 公證,您可以將它封裝在已簽署的 .app 中,並維持應用程式的公證有效。這正是 CloudLens 背後的模式,它是一個選單列雲端哨兵。

步驟​

  1. 新增套件至 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。

  1. 啟動伺服器並呼叫工具。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(_:) 會傳回解析後的啟動命令。

  1. 選擇模式。Options.mode 預設為 .readOnly。只有在應用程式需要佈建時,才設定 .safe、.deleteSafe 或 .fullAccess。權限提升需明確指定。

將經過公證的二進位檔封裝在已簽署的應用程式中​

darwin-universal 二進位檔以 Developer ID 簽署並經過 Apple 公證,因此可以封裝在已簽署的 macOS .app 中,同時維持應用程式本身的公證有效。二進位檔解析順序:

  1. 明確指定的 binaryOverride。
  2. 封裝在 .app 中的資源。
  3. 位於 ~/.stackql/mcp-server-bin/ 的共用快取。
  4. 下載並進行 sha256 驗證(設定 allowDownload 時)。

將經過公證的二進位檔放入應用程式資源,就會優先使用封裝的路徑,讓應用程式完全獨立,首次執行時不需下載。

示範應用程式​

CloudLens 是一個選單列雲端哨兵,它內嵌經過公證的二進位檔,並執行一系列 read_only 檢查。