إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

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