본문으로 건너뛰기
번역된 페이지

이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.

Swift

StackQL MCP 서버를 macOS 애플리케이션에 내장합니다. 서명 및 공증된 바이너리를 .app 번들 안에 포함할 수 있으며, 클라이언트는 공식 Swift MCP SDK입니다.

정보

임베디드 바이너리는 첫 실행 시 다운로드되어 sha256으로 검증되거나, 앱에 벤더링됩니다. 공통 계약을 참조하세요.


설치​

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 값으로 설정하세요. 승격은 명시적입니다. 옵트인하지 않으면 서버는 변경 작업 도구나 수명 주기 도구를 활성화하지 않습니다.


벤더링 / 내장​

darwin-universal 바이너리는 Developer ID로 서명되고 Apple 공증을 받았으므로, 앱 자체의 공증을 유효하게 유지하면서 서명된 macOS .app 번들 안에 포함할 수 있습니다. 이는 Swift 라이브러리만의 특징입니다. 첫 실행 시 다운로드 없이, 자체 포함되고 공증된 단일 애플리케이션을 제공할 수 있습니다.

바이너리 확인 순서:

  1. 명시적 binaryOverride 값.
  2. 번들된 .app 리소스.
  3. ~/.stackql/mcp-server-bin/ 디렉터리의 공유 캐시.
  4. sha256 검증을 포함한 다운로드(allowDownload 속성이 설정된 경우).

데모 앱​

CloudLens는 공증된 바이너리를 내장하고 read_only 검사 모음을 실행하는 메뉴 막대 클라우드 센티널입니다.


github.com/stackql/stackql-mcp-swift