/ الدليل / الملعب / cupertino
● مجتمع mihaelamj ⚡ فوري

cupertino

بواسطة mihaelamj · mihaelamj/cupertino

توثيق Apple محلي في متناول وكيلك — أكثر من 302 ألف صفحة، HIG وكود نموذجي، كل ذلك في SQLite FTS5 مع بحث أقل من 100 ميلي ثانية.

cupertino (mihaelamj) يتصفح توثيق مطوري Apple ويقدمه لعملاء MCP من فهرس SQLite FTS5 محلي. يوقف Claude عن اختراع واجهات برمجية UIKit/SwiftUI. حوالي 2.4 جيجابايت للمجموعة الكاملة؛ يغطي 307 أطر عمل، HIG، مشاريع نموذجية، Swift Evolution.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

cupertino.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "cupertino",
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "cupertino": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/mihaelamj/cupertino"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add cupertino -- TODO 'See README: https://github.com/mihaelamj/cupertino'

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: cupertino

إيقاف هلوسة API مع cupertino لوثائق Apple

👤 مطورو iOS / macOS / visionOS ⏱ ~10 min beginner

متى تستخدمه: عندما يستمر Claude في اختراع توقيعات API؛ تريده مدعوماً بوثائق حقيقية.

المتطلبات الأساسية
  • تثبيت cupertino — حمّل ملف Swift 6.2+ الثنائي؛ شغّل cupertino setup لسحب الفهرس
الخطوات
  1. إعداد الفهرس
    شغّل cupertino setup ثم cupertino serve. تأكد من أن خادم MCP يستمع.✓ تم النسخ
    → الخادم متصل
  2. فرض الوكيل للاستشهاد
    قبل كتابة أي كود SwiftUI، ابحث في وثائق cupertino عن API دقيقة. اقتبس التوقيع.✓ تم النسخ
    → API مُتحقق منه مع URI
  3. استخدمه
    الآن اكتب الكود باستخدام فقط واجهات البرمجة التي اقتبستها.✓ تم النسخ
    → يتم الترجمة من المحاولة الأولى

النتيجة: هلوسات API أقل بكثير.

مراجعة التصميم مقابل إرشادات واجهة المستخدم البشرية من Apple

👤 مصممو iOS، مديرو المنتجات ⏱ ~20 min intermediate

متى تستخدمه: قبل الإطلاق، تريد التحقق من تدفق مقابل HIG.

الخطوات
  1. وصف الشاشة
    أنا أبني شاشة إعدادات بزر تدميري 'حذف الحساب'. استخدم search_hig لـ iOS للعثور على إرشادات ذات صلة.✓ تم النسخ
    → فقرات HIG حول الإجراءات التدميرية
  2. تطبيق
    بناءً على تلك الإرشادات، انتقد نموذجي [الصق]. ما الذي ينتهك HIG؟✓ تم النسخ
    → انتهاكات محددة + إصلاحات

النتيجة: واجهة مستخدم متوافقة مع HIG بدون قراءة المستند بأكمله بنفسك.

اجمعها مع: claude-talk-to-figma

التعلم من مشاريع Apple النموذجية عبر cupertino

👤 المطورون الذين يتعلمون أطر عمل جديدة ⏱ ~15 min beginner

متى تستخدمه: تحتاج لمعرفة 'كيف تستخدم Apple هذه الواجهة البرمجية بالفعل'.

الخطوات
  1. البحث عن العينات الملائمة
    ابحث في search_samples عن 'علاقات SwiftData'. اسرد المشاريع المطابقة.✓ تم النسخ
    → أسماء المشاريع + الوصف
  2. قراءة المصدر
    في المشروع X، اقرأ ContentView.swift وشرح إعداد العلاقة.✓ تم النسخ
    → شرح مشروح

النتيجة: أنماط حقيقية موافقة عليها من Apple بدلاً من تخمينات المنتدى.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

تصميم في Figma، التحقق من صحة HIG عبر cupertino

بالنسبة للشاشة المحددة في Figma، ابحث في HIG عن القواعد ذات الصلة وضع علم على عدم التوافق.✓ تم النسخ
cupertino + filesystem

قارن كود SwiftUI الخاص بك مع عينة Apple للنمط نفسه

اقرأ ./Sources/ContentView.swift الخاص بي وقارن مع هيكل عينة SwiftData من Apple.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search_docs query, framework? بحث مرجعي عن API 0
search_hig query, platform? إرشادات التصميم 0
list_frameworks اكتشف ما تم فهرسته 0
read_document uri توسيع نتيجة بحث 0
search_samples query اكتشاف نموذج برمجي 0
list_samples تصفح 0
read_sample_file sample, path قراءة ملف معين 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا توجد — FTS5 محلي
الرموز لكل استدعاء
صفحات المستند: 500-5000 لكل صفحة
التكلفة المالية
مجاني
نصيحة
استخدم search_docs + read_document على أعلى نتيجة فقط بدلاً من إلقاء عدة صفحات

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: بلا بيانات اعتماد
نقل البيانات الخارجي: لا يوجد في وقت التشغيل؛ cupertino setup يسحب من developer.apple.com مرة واحدة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

البحث لا يعود بشيء بعد التثبيت

لم يتم إكمال cupertino setup — أعد التشغيل واراقب أخطاء الشبكة

تحقق: يجب أن يكون حجم ملف قاعدة البيانات حوالي 2.4 جيجابايت
وثائق قديمة بعد إصدار نظام التشغيل

أعد تشغيل cupertino setup لتحديث الزحف

فهرس قاعدة البيانات كبير جداً للجهاز

استخدم إعداد محدود الأطر لفهرسة فقط ما تحتاجه (على سبيل المثال SwiftUI فقط)

البدائل

cupertino مقابل البدائل

البديلمتى تستخدمهاالمقايضة
DuckDuckGo / بحث ويب MCPأنت لا تمانع خطر الهلوسة وتحتاج الأحدثليست موثوقة؛ قد ترجع مدونات تابعة لجهات خارجية
موقع Apple Developer مباشرةالقراءة الموجهة من الإنسانلا توجد أتمتة للوكيل

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills