إعداد ⁨Ollama⁩ مع ⁨MCP⁩ ⁨2026⁩: ربط النماذج المحلية بالملفات وقواعد البيانات و⁨APIs⁩

حقائق سريعة

• البروتوكول: JSON-RPC 2.0 عبر stdio (عملية فرعية محلية) أو Streamable HTTP (عن بُعد). نقل HTTP+SSE الأقدم مهجور. يستخدم الوكلاء المحليون stdio تقريباً حصراً. المراجعة الحالية للمواصفة هي 2026-07-28.
• الأصل: أنشأته Anthropic كمواصفة مفتوحة (modelcontextprotocol.io). لا يزال عدد قليل فقط من الخوادم المرجعية مُصاناً في modelcontextprotocol/servers (filesystem وgit وfetch وmemory وغيرها)؛ أما SQLite وPostgreSQL وPuppeteer وGitHub فقد انتقلت إلى servers-archived. والموردون يشحنون الآن خوادمهم الخاصة.
• العملاء المحليون: Goose (مفتوح المصدر، المستودع aaif-goose/goose)، وCline (امتداد VS Code)، وContinue.dev (VS Code/JetBrains)، وLM Studio (تطبيق سطح مكتب)، إضافة إلى عدة أدوات سطر أوامر.
• نماذج Ollama المتوافقة: أي نموذج بتدريب أصلي على استدعاء الأدوات، مثل Gemma 4 31B وGLM-4.7 Flash وQwen3.6 27B وQwen3 32B وQwen3-Coder 30B وLlama 3.3 70B.
• النقل الافتراضي للخوادم: stdio للعمليات المحلية؛ وStreamable HTTP فقط عندما تحتاج إلى مشاركة خادم بين أجهزة أو وكلاء.
• الإعداد يقع في العميل: يقرأ Goose كتلة extensions في ~/.config/goose/config.yaml (أو عبر goose configure)؛ وCline وContinue.dev لهما إعدادات MCP خاصة بهما. الحقول هي الفكرة نفسها في كل مكان: اسم الخادم، والأمر، والمعطيات، ومتغيرات البيئة.
• لا يلزم Claude Desktop. البروتوكول مفتوح ومستقل عن Claude Desktop؛ والخوادم المستخدمة هنا مفتوحة المصدر (تحقق من ترخيص كل منها) وتعمل مع أي عميل متوافق.

ما يُتيحه MCP لنموذج محلي

• "ابحث عن كل TODO في هذا المستودع، وجمّعها حسب الملف، واكتب ملخصاً بصيغة Markdown في notes/todos.md." — خادم filesystem يقرأ، والنموذج يجمّع، والخادم نفسه يكتب. رحلة واحدة من البداية إلى النهاية.
• "اعرض لي أفضل 10 عملاء من حيث الإيرادات هذا الربع، ثم ارسمها بيانياً." — خادم postgres ينفّذ SQL (بدور للقراءة فقط)، والنموذج يلخّص، ويكتب ملف CSV عبر filesystem لأداة الرسم لديك.
• "افتح الصفحة الرئيسية لـHacker News، وابحث عن أهم ثلاثة أخبار عن الذكاء الاصطناعي، ولخّصها، وأضفها إلى قائمة قراءتي." — خادم playwright يتحكم في المتصفح، والنموذج يستخرج ويلخّص، وfilesystem يضيف.
• "افتح مسودة PR بعنوان chore: bump deps على الـfork الخاص بي واربطها بتشغيل CI الفاشل." — خادم github ينشئ الـPR، ويجلب التشغيل، ويكتب الرابط في الوصف.
• "انظر إلى آخر 100 صف في events.db وأخبرني أي معرّفات مستخدمين مسؤولة عن ارتفاع الأخطاء الجديد." — خادم قاعدة بيانات يستعلم عن نسخة من البيانات؛ والنموذج يحلل؛ وتقرأ الإجابة في لوحة المحادثة.
• كل واحد من هذه سير عمل من جملة إلى إجراء، كان يتطلب سابقاً إما نموذجاً سحابياً بأدوات مستضافة أو سكربتاً مكتوباً يدوياً. MCP هو الطبقة التي تتيح لك إعادة استخدام الخوادم نفسها عبر العملاء، والنموذج نفسه عبر الخوادم.

مقارنة الخوادم الأربعة الأكثر استخداماً في MCP

كيف تتلاءم الأجزاء معاً

• Ollama يعمل كخدمة في الخلفية على 127.0.0.1:11434 ويقدّم النموذج عبر API متوافق مع OpenAI. لا يعرف ما هو MCP — يجيب فقط على chat completions ويُصدر tool calls حين يطلبها النموذج.
• عميل MCP (Goose أو Cline أو Continue.dev أو LM Studio) هو الجسر. يتحدث مع Ollama للنموذج ومع خوادم MCP للأدوات. حين يُصدر النموذج tool call، يوجّهها العميل إلى الخادم المناسب، ويستلم النتيجة، ويعيدها إلى المحادثة.
• خوادم MCP عمليات فرعية مستقلة، واحدة لكل قدرة. تتحدث JSON-RPC 2.0 عبر stdio. يعلن كل خادم قائمة Tools وResources وPrompts؛ ويدمجها العميل في سطح الأدوات المعروض على النموذج.
• نقل stdio يُبقي كل شيء محلياً. يطلق العميل الخادم، ويتواصل معه عبر stdin/stdout، وينتهي الخادم حين ينتهي العميل. لا شيء يمر عبر الشبكة ما لم يفتح الخادم نفسه اتصالاً (خادم المتصفح يفعل؛ أما خادما filesystem وقاعدة البيانات فلا).
• يرى النموذج قائمة أدوات مسطحة واحدة. من منظور النموذج لا توجد خوادم — فقط قائمة بأسماء أدوات مثل filesystem.read_file وplaywright.browser_navigate وgithub.create_pull_request. والعميل يتولى التوجيه.

الإعداد: Ollama + Goose في 15 دقيقة

• الخطوة 1 — ثبّت Ollama. نزّله من ollama.com/download (macOS/Windows/Linux). تأكد أن الخدمة تعمل بالأمر curl http://127.0.0.1:11434/api/tags.
• الخطوة 2 — نزّل نموذجاً يدعم استدعاء الأدوات. اختر من Gemma 4 31B (gemma4:31b) أو GLM-4.7 Flash (glm-4.7-flash) أو Qwen3.6 27B (qwen3.6:27b) أو Qwen3 32B (qwen3:32b) أو Llama 3.3 70B (llama3.3:70b). ذاكرة موحدة بحجم 32 GB أو 24 GB من VRAM تشغّل نماذج 26B–32B عند Q4_K_M بارتياح.
• الخطوة 3 — ثبّت Goose. على macOS أو Linux شغّل curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash (أو brew install block-goose-cli). على Windows استخدم مثبّت PowerShell من وثائق Goose، أو WSL. تُثبَّت الأداة باسم goose.
• الخطوة 4 — اضبط Ollama كمزوّد. شغّل goose configure، واختر ollama كمزوّد، واضبط النموذج على الذي نزّلته، واضبط المضيف على http://127.0.0.1:11434 (ترك الحقل فارغاً يعني localhost:11434 أيضاً). يكتب Goose ذلك في ~/.config/goose/config.yaml. قد تكون نافذة السياق الافتراضية في Ollama صغيرة (توثيق Goose يذكر 4096 توكن)، وقد يجعل ذلك Goose يتجاهل إضافاته — شغّل Ollama مع OLLAMA_CONTEXT_LENGTH=32768 (أو أعلى).
• الخطوة 5 — أضف خادم filesystem MCP. شغّل goose configure، واختر Add Extension، ثم Command-line Extension، أو أضف كتلة extensions إلى ~/.config/goose/config.yaml (المثال أدناه). للتجربة السريعة، الأمر goose session --with-extension "npx -y @modelcontextprotocol/server-filesystem /path/to/workspace" يفعّله لتلك الجلسة فقط. ابدأ goose session واطلب منه سرد الملفات في دليل الاختبار. الدور الأول يؤكد أن الخادم متصل.
• الخطوة 6 — تحقق بمهمة حقيقية. جرّب goose session واطلب: "أنشئ قائمة بكل ملف Markdown في notes/ مع العنوان وعدد الكلمات، واكتب النتيجة في notes/index.md." إذا قرأ الوكيل ولخّص وكتب النتيجة، فالحلقة تعمل.

# 1. Pull a tool-calling model
ollama pull gemma4:31b

# 2. Install Goose (macOS / Linux)
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

# 3. Configure Ollama as the provider
goose configure
# Provider: ollama
# Model:    gemma4:31b
# Host:     http://127.0.0.1:11434

# 4. Give Ollama a context window big enough for tool use, then start a session
OLLAMA_CONTEXT_LENGTH=32768 ollama serve   # in a separate terminal
goose session

خادم Filesystem: قراءة دليل معزول وكتابته

• التثبيت: الخادم المرجعي هو @modelcontextprotocol/server-filesystem، يُشغَّل عبر npx -y (لا حاجة لتثبيت عام؛ يلزم Node.js). وهو أحد الخوادم المرجعية التي ما زالت مُصانة. يطلقه Goose وCline وContinue.dev من إعداداتها.
• مسارات السماح: يقبل الخادم وسيطاً واحداً أو أكثر لأدلة ويرفض أي عملية خارجها. مرّر دائماً مساراً صريحاً وضيقاً — لا ~ ولا / أبداً.
• الأدوات المعروضة: read_file وread_multiple_files وwrite_file وedit_file (استبدالات على مستوى الأسطر) وlist_directory وsearch_files وmove_file وcreate_directory وdirectory_tree. يراها النموذج باسم filesystem.read_file وهكذا.
• تسهيلات الاستخدام: directory_tree يعيد شجرة JSON؛ مثالية ليتعرّف النموذج على البنية قبل قراءة ملفات محددة. وsearch_files يجري بحثاً تكرارياً شبيهاً بـgrep.
• سطح المخاطر: يحترم الخادم قائمة السماح، لكنه داخلها يملك صلاحية قراءة وكتابة كاملة. اعتبر قائمة السماح الحاجز الوحيد، واختر دليل عمل مخصصاً بدل مجلدك الرئيسي.

# ~/.config/goose/config.yaml
extensions:
  filesystem:
    type: stdio
    name: filesystem
    enabled: true
    cmd: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/agent-workspace"]
    envs: {}
    timeout: 300

خوادم قواعد البيانات: الاستعلام بأمان عن Postgres (وSQLite)

• Postgres: postgres-mcp (من Crystal DBA، ترخيص MIT) هو الخيار الذي يملك وضع القراءة فقط (آخر إصدار على PyPI يعود إلى مايو 2025، فتحقق من نشاط المستودع قبل الاعتماد عليه). شغّله بـuvx postgres-mcp --access-mode=restricted (أو pipx install postgres-mcp، أو صورة Docker الخاصة به) ومرّر URI الاتصال في متغير البيئة DATABASE_URI. الوضع المقيَّد يسمح بمعاملات القراءة فقط وبحد زمني للاستعلام؛ أما الوضع غير المقيَّد فللتطوير فقط.
• استخدم دوراً مخصصاً للقراءة فقط أيضاً. الوضع المقيَّد حاجز، ودور قاعدة البيانات حاجز آخر. أنشئ دور agent_ro بصلاحيات SELECT فقط واستخدم سلسلة اتصال ذلك الدور.
• SQLite: الخادم المرجعي مؤرشف. هو حزمة Python باسم mcp-server-sqlite (وليس حزمة npm؛ آخر إصدار في أبريل 2025)، وقد يظل يعمل، لكنه لا يتلقى إصلاحات. وجّهه إلى نسخة من الملف فقط، لا إلى نسختك الوحيدة، أو حمّل البيانات في Postgres بدلاً من ذلك. اقرأ كود أي خادم SQLite من المجتمع قبل أن تمنحه ملفاً.
• الوعي بالمخطط: اطلب من الوكيل "اسرد الجداول ووصف الأكثر استخداماً منها (خمسة)" قبل طرح أسئلة تحليلية — يكون النموذج أدق بكثير بعد فحص المخطط مما لو خمّن أسماء الأعمدة.
• التكلفة: الاستعلامات تضرب قاعدة بياناتك مباشرةً. استعلام SELECT * سيئ الصياغة على جدول من 100 مليون صف حادث هنا كما لو صدر من إنسان — أبقِ الدور على مجمّع اتصالات منفصل مع مهلة للاستعلام (statement timeout).

# ~/.config/goose/config.yaml
extensions:
  postgres:
    type: stdio
    name: postgres
    enabled: true
    cmd: uvx
    args: ["postgres-mcp", "--access-mode=restricted"]
    envs:
      DATABASE_URI: "postgresql://agent_ro:${PG_AGENT_PASSWORD}@127.0.0.1:5432/analytics"
    timeout: 300

خادم المتصفح: التحكم في متصفح عبر Playwright MCP

• أي خادم: استخدم @playwright/mcp من Microsoft (npx @playwright/mcp@latest). حزمة @modelcontextprotocol/server-puppeteer القديمة موسومة بأنها "لم تعد مدعومة"، ولا توجد حزمة باسم @modelcontextprotocol/server-playwright على npm.
• الأدوات المعروضة: browser_navigate وbrowser_snapshot وbrowser_click وbrowser_type وbrowser_fill_form وbrowser_evaluate (تشغيل JavaScript) وbrowser_take_screenshot وbrowser_tabs وbrowser_wait_for. يقرأ النموذج الصفحة عبر browser_snapshot (لقطة إمكانية وصول، وتوصي Playwright MCP بها على لقطات الشاشة عند تنفيذ الإجراءات) ويستخدم لقطات الشاشة للاطلاع فقط.
• زمن الاستجابة: جلسات المتصفح الحقيقية تستغرق 1–5 ثوانٍ لكل إجراء. وتصفح متعدد الخطوات يستهلك بسهولة 30–60 ثانية وعشرات الآلاف من التوكنات لأن محتوى الصفحة كبير. استخدم نافذة سياق 32K+.
• مراجع العناصر: ينقر النموذج على العناصر بحسب المراجع في اللقطة. النماذج الأصغر تختار العنصر الخطأ كثيراً؛ ونموذج 27B+ يدعم استدعاء الأدوات يتعامل مع الأنماط الشائعة بموثوقية. أبقِ المهام محددة النطاق — "استخرج عنوان هذا الرابط وفقرته الأولى" أوثق بكثير من "تنقّل في الموقع وابحث عن صفحة التواصل".
• حالات الاستخدام المناسبة: البحث (افتح الصفحة ولخّصها وأضفها إلى الملاحظات)، واختبارات الانحدار (تنقّل وانقر والتقط لقطة)، وتعبئة النماذج في صفحات تتحكم بها. وغير المناسبة: كل ما تترتب على نقرة خاطئة فيه عواقب على الويب الحي.

# ~/.config/goose/config.yaml
extensions:
  playwright:
    type: stdio
    name: playwright
    enabled: true
    cmd: npx
    args: ["@playwright/mcp@latest"]
    envs: {}
    timeout: 300
# Block obviously dangerous endpoints at the OS firewall level
# rather than relying on the agent to refuse them.

خادم GitHub: المستودعات وIssues وPRs من نموذج محلي

• التثبيت: استخدم github/github-mcp-server الرسمي من GitHub، يُشغَّل من صورة Docker الخاصة به (ghcr.io/github/github-mcp-server) مع PAT في متغير البيئة GITHUB_PERSONAL_ACCESS_TOKEN. حزمة npm القديمة @modelcontextprotocol/server-github موسومة بأنها "لم تعد مدعومة"؛ لا تستخدمها في الإعدادات الجديدة.
• الأدوات المعروضة: search_repositories وget_file_contents وcreate_or_update_file وcreate_pull_request وlist_issues وcreate_issue وadd_issue_comment وmerge_pull_request، وغيرها الكثير. السطح الكامل كبير؛ ومعظم المهام تستخدم 5–10 أدوات.
• قيّد الـPAT. استخدم PAT دقيق الصلاحيات (fine-grained) مقيّداً بمستودعات محددة بأدنى الأذونات اللازمة (Read للتصفح، Write لإنشاء PRs وissues). لا تستخدم PAT كلاسيكياً بصلاحية repo لوكيل تجريبي.
• سير عمل حقيقية: الفرز ("اقرأ آخر 20 issue مفتوحة وجمّعها واقترح تسميات")، والصياغة ("اقرأ README وافتح PR يصحح الأخطاء الإملائية")، والتقارير ("أي PRs راكدة هذا الأسبوع").
• سطح المخاطر: يستطيع الوكيل إنشاء issues وPRs والتعليق عليها، و(مع صلاحيات الكتابة) دفع commits. عطّل أدوات الدمج ما لم تثق بالنموذج وسير العمل معاً — دمج بالخطأ في مستودع بـPAT دقيق الصلاحيات يمكن التراجع عنه، لكن فقط إن لاحظته سريعاً.

# ~/.config/goose/config.yaml
extensions:
  github:
    type: stdio
    name: github
    enabled: true
    cmd: docker
    args: ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"]
    envs:
      GITHUB_PERSONAL_ACCESS_TOKEN: "${GH_AGENT_PAT}"
    timeout: 300
# Fine-grained PAT scoped to one or two test repos,
# not your personal account-wide classic token.

نموذج أمان لا يثق في النموذج

• اعزل خادم filesystem في دليل واحد. لا ~ ولا / أبداً. اختر مجلد agent-workspace/ وضع فيه نسخاً من الملفات التي يحتاج الوكيل لمسها. إذا حدث خطأ، فأسوأ الاحتمالات مجلد واحد.
• شغّل خوادم قواعد البيانات للقراءة فقط افتراضياً. دور agent_ro مخصص بصلاحيات SELECT فقط ومهلة استعلام 30 ثانية يزيل فئة كاملة من الحوادث.
• ضع كل أداة كتابة أو shell خلف موافقة صريحة. يدعم Goose وCline وContinue.dev جميعاً قواعد موافقة لكل أداة. اسمح بأدوات القراءة افتراضياً؛ واشترط الموافقة لـwrite_file وedit_file وexecute_command وcreate_pull_request وأي إجراء متصفح يرسل نماذج.
• استخدم سجل التدقيق. كل عميل MCP يسجّل استدعاءات الأدوات ونتائجها. بعد جلسة طويلة، افحص السجل: ستلتقط محاولات من النموذج لم تتوقعها (بعضها غير ضار، وبعضها يستحق تشديد الأذونات).
• قيّد وصول الأطراف الثالثة بالتوكن بدقة. PATs في GitHub مقيّدة بمستودعي اختبار. أدوار Postgres للقراءة فقط. جلسات متصفح بلا بيانات اعتماد. سيحاول النموذج في النهاية أشياء لم تتوقعها؛ ويجب ألا تعتمد حدود ما يستطيع فعله على إصابته الصواب.
• اعزل الوكيل عن الشبكة عند التعامل مع بيانات حساسة. عطّل وصول الشبكة على المضيف أثناء تشغيل الوكيل (أو استخدم network namespace) عند العمل على بيانات خاصة. المكدس المحلي لا يُخرج أي شيء من الجهاز أصلاً، لكن الدفاع المتعدد الطبقات يلتقط أخطاء خوادم الأطراف الثالثة.
• عامل اختيار خادم MCP كأي اختيار لاعتمادية برمجية. الخوادم المرجعية مُصانة جيداً؛ أما كثير من خوادم الأطراف الثالثة فلا. اقرأ كود الخادم قبل تثبيت أي خادم يحتاج إلى بيانات اعتماد.

MCP محلي مقابل Claude Desktop: ما يتغير وما يبقى

اختيار نموذج استدعاء الأدوات لـMCP المحلي

• Gemma 4 31B (gemma4:31b) — تدريب Google على استدعاء الأدوات هو الأفضل في فئته لهذا الحجم. يتسع في ذاكرة موحدة 16 GB أو 24 GB VRAM عند Q4_K_M. استدلال عام جيد؛ ومحافظ نوعاً ما في الاستدعاءات المتسلسلة.
• GLM-4.7 Flash (glm-4.7-flash) — نموذج Zhipu يتمتع بموثوقية قوية جداً في استدعاء الأدوات ونافذة سياق 128K جاهزة. أثقل قليلاً من Gemma 4؛ ويتسع بارتياح على بطاقة 24 GB.
• Qwen3.6 27B (qwen3.6:27b) — خيار Qwen الأحدث على Ollama (نحو 18–19 GB، وسياق 256K، واستدعاء الأدوات مدعوم). Qwen3 32B (qwen3:32b) — متوازن؛ نموذج كثيف بحجم 32B يتعامل مع MCP بشكل نظيف ويرتاح في حلقة وكيل طويلة. Qwen3-Coder 30B (qwen3-coder:30b) هو الأفضل إذا كان عمل وكيلك مرتكزاً على الكود.
• Llama 3.3 70B (llama3.3:70b) — أعلى سقف لكنه الأثقل. ذاكرة موحدة 48 GB+ أو بطاقتان 24 GB عند Q4_K_M. استخدمه فقط إذا كان عتادك يتحمله؛ فالنماذج الأصغر تكفي غالباً.
• تجنّب لأعمال MCP: أي نموذج أقل من 7B وأي نموذج للأغراض العامة بلا تدريب صريح على استدعاء الأدوات. سيُصدر استدعاءات مشوّهة، وستتوقف الحلقة، وستلوم أداة التشغيل — لكنها سليمة.
• لتقنيات الصياغة المنظمة التي تحسّن جودة استدعاء الأدوات على أي نموذج، راجع chain-of-thought prompting.
• للبيانات المقارنة المباشرة، راجع أفضل النماذج المحلية لاستدعاء الأدوات في 2026.

MCP مقابل Function Calling البسيط: ما الفرق

• Function calling قدرة في جانب النموذج: يُصدر النموذج كائن JSON منظماً يصف اسم الأداة ومعطياتها. أدوات OpenAI وAnthropic وواجهة tool-call في Ollama تستخدم الفكرة نفسها بصيغ نقل مختلفة قليلاً.
• MCP يقع فوقه: يوحّد طريقة وصف الأدوات واكتشافها واستدعائها وإعادة نتائجها عبر العمليات. نموذج function calling وحده لا يعرف شيئاً عن نظام ملفاتك؛ خادم MCP يتيح عمليات الملفات، ويربطها العميل بواجهة function calling الخاصة بالنموذج، فيستطيع النموذج استدعاءها.
• الفائدة هي قابلية التشغيل البيني. اكتب خادم الملفات مرة واحدة؛ فيستخدمه Claude Desktop وGoose وCline وContinue.dev وLM Studio دون تغيير. بدّل النموذج من Claude إلى Gemma 4؛ ولا يتغير الخادم.
• يمكنك بناء وكلاء بـfunction calling الخام. لكنك ستعيد تنفيذ معالجات الملفات وقواعد البيانات والمتصفح في كل مشروع. أما مع MCP فهي اعتماديات جاهزة.
• للسكربتات لمرة واحدة، function calling الخام أبسط. أما لكل ما تريد إعادة استخدامه عبر المشاريع أو النماذج، فMCP هو الطريق الأقل جهداً خلال أيام قليلة.

الأخطاء الشائعة في إعداد MCP المحلي

• الخطأ 1: استخدام نموذج صغير للأغراض العامة. النماذج الأقل من 7B (ومعظم نماذج 7B–13B العامة بلا ضبط دقيق على استدعاء الأدوات) تُصدر tool calls مشوّهة. استخدم نموذجاً بحجم 27B+ مضبوطاً لاستدعاء الأدوات وتوقف عن محاربة أداة التشغيل.
• الخطأ 2: وضع دليلك الرئيسي في قائمة السماح. قوائم السماح "للاختبار فقط" التي تضم ~ تنتقل إلى الاستخدام الروتيني. أنشئ agent-workspace مخصصاً منذ البداية.
• الخطأ 3: ترك خادم قاعدة البيانات في وضع القراءة والكتابة. استعلام DELETE يكتبه وكيل واثق على جدول حقيقي هو بالضبط الحادث الذي يتجنبه هذا الإعداد. اجعل agent_ro افتراضياً؛ وأنشئ دوراً قابلاً للكتابة منفصلاً فقط للمهام التي تتطلب ذلك صراحةً، ولمدة تلك المهام فقط.
• الخطأ 4: الموافقة التلقائية على كل أداة. مفتاح "وافق على الكل" مريح وخطير. وافق تلقائياً على أدوات القراءة (read_file وlist_directory وquery)؛ واشترط الموافقة دائماً لأدوات الكتابة وshell وPR.
• الخطأ 5: تشغيل نموذج بسياق 32K في عمل متصفح متعدد الخطوات. محتوى الصفحات كبير؛ ووكيل يتصفح ثلاث صفحات قد يستهلك 32K توكن قبل أن يبدأ الاستدلال. استخدم نموذجاً بسياق 128K للمهام الثقيلة على المتصفح.
• الخطأ 6: افتراض أن الوكيل يملك حكماً. لا يملكه. النموذج لا يعرف أن "هذه قاعدة بيانات الإنتاج" أو أن "هذا الـPR سيُنشَر". الأذونات هي حاجزك الوحيد.
• الخطأ 7: تثبيت كل خادم مرجعي منذ البداية. أدوات أكثر = موجّه نظام أكبر = اختيار أدوات أبطأ وأقل موثوقية. ابدأ بـfilesystem. وأضف الباقي فقط حين يكون لديك سير عمل يحتاجها.
• الخطأ 8: تثبيت خوادم مرجعية مؤرشفة من شروحات قديمة. حزم npm ‏@modelcontextprotocol/server-postgres و-puppeteer و-github موسومة بأنها "لم تعد مدعومة"، وخادم SQLite مؤرشف. وبعض الشروحات القديمة تذكر أيضاً حزم npm غير موجودة (server-sqlite وserver-playwright). استخدم الخوادم المُصانة المذكورة أعلاه.
• الخطأ 9: وضع إعداد MCP في Ollama. Ollama لا يملك إعدادات MCP. الخوادم تُضبط في العميل (extensions في Goose، أو إعدادات MCP في Cline أو Continue.dev).

المصادر

• مواصفة بروتوكول سياق النموذج — المواصفة الرسمية ومخطط JSON-RPC وتعريفات النقل ودورة الحياة، بما في ذلك سجل تغييرات 2026-07-28.
• مستودع modelcontextprotocol/servers على GitHub — الخوادم المرجعية المُصانة (filesystem وgit وfetch وmemory وغيرها) وقائمة الخوادم المؤرشفة.
• github/github-mcp-server — خادم MCP الرسمي من GitHub، وإعداد Docker والملف التنفيذي.
• microsoft/playwright-mcp — خادم Playwright MCP وأدوات المتصفح فيه.
• crystaldba/postgres-mcp — خادم Postgres MCP بوضع وصول مقيَّد (قراءة فقط).
• وثائق Goose — تثبيت أداة سطر الأوامر، وإعداد مزوّد Ollama، وصيغة إعداد الإضافات (خوادم MCP).
• مكتبة نماذج Ollama — النماذج المحلية المتاحة، وأعلام دعم استدعاء الأدوات، ومستويات التكميم المذكورة في هذا الدليل.
• مستودع Cline على GitHub — تنفيذ عميل MCP لـVS Code، ولوحة خوادم MCP.
• وثائق Continue.dev — مرجع كتلة الإعداد mcpServers لعميل Continue.dev.

الأسئلة الشائعة

قراءة ذات صلة

• أفضل النماذج المحلية لاستدعاء الأدوات في 2026 — معايير مقارنة مباشرة للنماذج الموصى بها أعلاه (Gemma 4 وGLM-4.7 وQwen3 وLlama 3.3).
• وكلاء الذكاء الاصطناعي المحلي الذاتيون يعملون فعلاً — تحقق من الواقع حول ما يستطيع وكيل MCP المحلي وما لا يستطيع فعله بشكل موثوق في مهمة طويلة الأمد.
• Continue.dev مقابل Cline مقابل Aider: أفضل وكيل برمجة محلي في 2026 — سياق وكيل مجاور للعمل المرتكز على الكود؛ Cline وContinue.dev أيضاً عملاء MCP.
• أفضل نماذج لغوية محلية في 2026 — مرجع النماذج لمشهد الأوزان المفتوحة الأشمل.
• استبدال Zapier بوكلاء الذكاء الاصطناعي المحلي — إطار أتمتة سير العمل لنفس مكدس MCP.
• مركز Power Local LLM — مكتبة كاملة من الأدلة.