/ الدليل / الملعب / apple-docs-mcp
← كل الخوادم ↗ GitHub
● مجتمع kimsungwhee ⚡ فوري

apple-docs-mcp

بواسطة kimsungwhee · kimsungwhee/apple-docs-mcp

ابحث في مستندات Apple للمطورين ونصوص فيديوهات WWDC (2014-2025) وعينات الأكواد من الدردشة — إجابات معتمدة على iOS/macOS/Swift.

يكشف kimsungwhee/apple-docs-mcp عن 15 أداة على محتوى developer.apple.com و1,260+ نص فيديو WWDC. ممتاز لوقف وكيلك عن اختلاق واجهات برمجية UIKit/SwiftUI.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

apple-docs.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "apple-docs",
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "apple-docs": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "apple-docs-mcp"
        ]
      }
    }
  }
}

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

claude mcp add apple-docs -- npx -y apple-docs-mcp

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

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

استخدامات عملية: apple-docs-mcp

كيفية منع وكيلك عن اختلاق واجهات برمجية SwiftUI

👤 مطورو iOS الذين يستخدمون Claude/Cursor ⏱ ~10 min beginner

متى تستخدمه: عندما يقترح الوكيل واجهات برمجية غير موجودة في إصدار iOS الذي تستهدفه.

المتطلبات الأساسية
  • Node 18+ — nvm install 20
الخطوات
  1. التثبيت
    ثبّت عبر: npx -y @kimsungwhee/apple-docs-mcp@latest (أو أضفها إلى إعدادات MCP).✓ تم النسخ
    → تظهر الأدوات
  2. أسس سؤالك
    استخدم search_apple_docs للعثور على 'navigationDestination' و get_platform_compatibility للتحقق من أنها متاحة على iOS 16+.✓ تم النسخ
    → مدخل المستند الرسمي + الحد الأدنى لهدف النشر
  3. أنسب في الكود
    الآن اكتب كود التنقل مع الاستشهاد بالمستند الذي قرأته للتو.✓ تم النسخ
    → كود + استشهادات

النتيجة: كود يترجم ضد هدف النشر الخاص بك.

المزالق
  • واجهات برمجية WWDC فقط موضحة قبل الإصدار — تحقق من get_platform_compatibility — تُسَجَّل واجهات بيتا البرمجية
اجمعها مع: github

كيفية العثور على جلسة WWDC التي تشرح ميزة

👤 مطورو iOS الذين يعتمدون ميزة جديدة ⏱ ~10 min beginner

متى تستخدمه: المستندات موجزة؛ السياق موجود في حديث WWDC لم تشاهده.

الخطوات
  1. ابحث في WWDC
    search_wwdc_videos 'Observation framework Swift macro' years=[2023,2024].✓ تم النسخ
    → قائمة الجلسات
  2. اسحب النص + الكود
    get_wwdc_video_details للنتيجة الأولى. استخرج أمثلة الأكواد.✓ تم النسخ
    → النص + مقتطفات الأكواد

النتيجة: السياق + كود عامل دون مشاهدة الفيديو.

كيفية التخطيط للهجرة من واجهة برمجية مهملة

👤 مطورو iOS الذين يحافظون على قواعد أكواد أقدم ⏱ ~10 min intermediate

متى تستخدمه: يقول التحذير 'مهمل في iOS 17' وتريد البديل.

الخطوات
  1. تأكيد الإهمال
    get_platform_compatibility لـ UIActivityIndicatorView.startAnimating.✓ تم النسخ
    → الجدول الزمني للتوافرية
  2. ابحث عن البديل الموصى به
    find_similar_apis — ما المكافئ SwiftUI؟✓ تم النسخ
    → ProgressView() مع الوسائط المناسبة

النتيجة: خطة هجرة واثقة مع المراجع.

اجمعها مع: github

التركيبات

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

apple-docs + github

أسس طلب دمج الهجرة بالمستندات + مراجع WWDC

ابحث عن بديل SwiftUI لاستخدام UIKit ActivityViewController، استشهد بمستندات Apple وجلسات WWDC، وصِغ مسودة طلب دمج الهجرة.✓ تم النسخ
apple-docs + filesystem

امسح الكود المحلي عن واجهات برمجية مهملة واقترح بدائل

ابحث في Sources/ عن أي واجهة برمجية مهملة حسب apple-docs-mcp؛ أنتج قائمة تحقق من الهجرة.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search_apple_docs query: str, platform?: str ابحث عن أي واجهة برمجية بالاسم أو الموضوع free
get_apple_doc_content url_or_id اقرأ الصفحة الكاملة بعد البحث free
list_technologies category?, include_beta?: bool استعرض الأطر الهيكلية free
search_framework_symbols framework, query بحث الرموز بنطاق محدد free
get_related_apis symbol الوراثة/تجاوز المطابقة free
get_platform_compatibility symbol تحقق من التوافرية free
find_similar_apis symbol بدائل للواجهات البرمجية المهملة free
get_sample_code topic? ابحث عن مشاريع عينات Apple free
search_wwdc_videos query, years?: int[], topics?: str[] ابحث عن محادثات WWDC free
get_wwdc_video_details session_id السياق الكامل للجلسة free

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

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

حصة API
developer.apple.com لديها حدود معدل الاستخدام المعقول؛ تُخزّن الأداة نتائجها لتقليل الاستدعاءات
الرموز لكل استدعاء
المستندات: 500-3000 رمز. النصوص: حتى 20000 رمز للجلسات الطويلة
التكلفة المالية
مجاني
نصيحة
استخدم search_framework_symbols بدلاً من search_apple_docs الواسع لتوفير الرموز.

الأمان

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

الحد الأدنى من الصلاحيات: لا توجد — المستندات العامة فقط
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: developer.apple.com + فهرس دون اتصال مجمع
لا تمنح أبدًا: لا شيء للمنح

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

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

لا تعيد البحث أي نتائج

قد تكون الاستعلام محددة جداً — جرب اسم الفئة وحده أو استخدم list_technologies للاستعراض.

يبدو أن محتوى المستند مقطوع

بعض الصفحات كبيرة؛ تقطع الأداة — مرّر عنوان URL إلى get_apple_doc_content الذي يتعامل مع الترقيم.

لم يتم العثور على فيديو WWDC

بعض الجلسات الأقدم لم يتم نسخ نصوصها. استخدم search_wwdc_videos مع مرشح السنوات.

البدائل

apple-docs-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
apple-docs عبر firecrawlتريد الكشط الخامبدون فهرس WWDC، بدون هيكل
context7 MCPتريد مستندات مكتبة عامة، ليست خاصة بـ Appleتغطية Apple أضعف

المزيد

الموارد

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

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

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