# Maguyva

وصفات قصيرة لسير عمل Maguyva MCP الشائع: تثبيت عميل، والبحث قبل التعديل، ومعالجة النتائج الفارغة، والعمل عبر مستودعات متعددة.

[llms-full.txt — English documentation and MCP schemas](/llms-full.txt)

Markdown representation of any docs page or blog post: append `.md` to its URL (https://maguyva.ai/ar/docs/quickstart.md) or send `Accept: text/markdown`.

Release feeds: [RSS](https://maguyva.ai/ar/changelog.xml), [JSON Feed 1.1](https://maguyva.ai/ar/changelog.json).

## قدرات اللغات

أدناه أعداد القدرات التي تُشغِّل البحث البنيوي، والبحث عن الرموز، والتحليل المراعي لبنية الرسم البياني، والفهرسة الأساسية.

تُظهر هذه المؤشرات القدرات المفعّلة في إعدادات اللغات الحالية، وليست درجات لجودة الأداء من البداية إلى النهاية. يتطلب توفر الرسم البياني تفعيل المحلّل واستخراج الرموز واستخراج الرسم البياني. تختلف أنواع العلاقات المدعومة وعمق الاستخراج بحسب اللغة.

- التغطية المفهرسة: **284**. كل لغة مُدرجة مفهرسة من حيث سياق الملفات والنص والمستودع.
- البحث البنيوي القائم على AST: **247**. اللغات التي تمتلك بنية مدعومة بمحلل لتحليل AST وسير عمل البحث البنيوي.
- استخراج الرموز: **282**. لغات تتوفر لها بيانات وصفية للرموز لاستخدامها في التعريفات والبحث.
- علاقات الرسم البياني: **151**. اللغات التي يتوفر لها استخراج تشغيلي للعلاقات من أجل البحث المراعي لبنية الرسم البياني. يختلف عمق الرسم البياني باختلاف اللغة ونوع العلاقة.

- `ast_structural=false`: فهرسة تقوم على النص أولًا، مع وعي بنيوي أخف.
- `symbol_extraction=false`: استخلاص الرموز محدود، لذا يعتمد التنقل بشكل أكبر على سياق الملف والبنية.
- `relationship_extraction=false`: تُفهرس هذه اللغة لأغراض البحث، لكنها لا تُحفظ حاليًا في الرسم البياني للشيفرة.

[ابحث عن لغتك](/llms-full.txt)

## دليل الوصفات

وصفات عملية للعمل اليومي باستخدام Maguyva MCP. تحدد كل وصفة الأدوات وتسلسلها، وليست مرجعًا كاملًا للمعاملات. راجع [مرجع MCP API](https://maguyva.ai/ar/docs/mcp-api) لمعاملات الأدوات، واستخدم [البدء السريع](https://maguyva.ai/ar/docs/quickstart) للإعداد لأول مرة.

### اختر الأداة المناسبة

تبدأ معظم الأسئلة باستدعاء واحد. انتقل إلى خطوة أعمق فقط عندما تكون الإجابة الأولى واسعة جدًا أو محدودة جدًا.

- `intelligent_search` — ابدأ هنا لطرح سؤال بلغة طبيعية عن قاعدة الشيفرة. يوجّه الوضع الافتراضي auto/balanced أسئلة التعريف التي يمكن تحديد مقصدها بثقة إلى البحث البنيوي، وأسئلة المراجع أو التأثير إلى الرسم البياني، وأسئلة التطابق التام إلى النص. وتستخدم الأسئلة الأخرى البحث الدلالي والنص المفهرس. لطلب الأنماط الأربعة جميعًا، استخدم mode=hybrid أو auto مع quality=thorough. تكون الأولوية للوضع المحدد صراحةً على quality.
- `find_symbol` — عندما تعرف مسبقًا اسم الدالة أو الفئة أو المتغير.
- `dependency_search` — لمعرفة نطاق التأثير: المستدعون والتابعون والأثر قبل التعديل وبعده.
- `get_task_context` — لمنطقة غير مألوفة؛ يعيد حزمة محدودة من الملفات والرموز والتبعيات بناءً على وصف المهمة.
- `repository_context` — لسرد المستودعات المتاحة أو فحص كيفية تحديد المستودع من اسمه.
- `ask_maguyva` مع `operation="guidance"` — مساعدة محلية لاختيار الأدوات واستخدام Maguyva من دون تعديل المستودع.

## Tools -- Search

- [intelligent_search](https://maguyva.ai/ar/docs/mcp-api#intelligent-search): Start here for any codebase question. Default auto/balanced routes confident definition queries to structural search, reference/impact queries to graph, and exact-match queries to text; other queries use semantic plus text.
- [semantic_search](https://maguyva.ai/ar/docs/mcp-api#semantic-search): Find code by meaning, not exact text. Use for conceptual queries like "retry logic" or "user onboarding flow" when you don't know the keyword or symbol name.
- [text_pattern_search](https://maguyva.ai/ar/docs/mcp-api#text-pattern-search): Search indexed content. Exact and regex modes grep the full file/blob corpus; fuzzy content mode searches the bounded semantic chunk corpus.

## Tools -- Structural & Graph

- [structural_search](https://maguyva.ai/ar/docs/mcp-api#structural-search): Prefer preset=functions|classes|methods|imports|variables (or free pattern=). Find code by AST shape (not text).
- [dependency_search](https://maguyva.ai/ar/docs/mcp-api#dependency-search): Primary blast-radius / graph surface. Answer "what calls this?" / "what does this use?" via the real call/import graph.

## Tools -- Code Analysis

- [find_symbol](https://maguyva.ai/ar/docs/mcp-api#find-symbol): Jump to where a function, class, or variable is defined and used. Use when you know the name (e.g. "getCurrentUser") — faster and more precise than Grep, and it spans the whole indexed repo.
- [analyze_dependencies](https://maguyva.ai/ar/docs/mcp-api#analyze-dependencies): Analyze blast radius using the same traversal as dependency_search (dependents/incoming). Prefer dependency_search with analysis_type="dependents" or "impact" for impact analysis.
- [get_task_context](https://maguyva.ai/ar/docs/mcp-api#get-task-context): Starting work in an unfamiliar area? Describe the task (e.g. "add SSO support", "fix the billing webhook") and get a bounded one-call bundle of relevant files, code, symbols, and dependencies.
- [get_file](https://maguyva.ai/ar/docs/mcp-api#get-file): Read a file from the indexed repo by path. Prefer local file tools for files on disk; use this for remote indexed snapshots.

## Tools -- Utility

- [repository_context](https://maguyva.ai/ar/docs/mcp-api#repository-context): List the repositories you can search, or get identity info on one (namespace/branch, indexed_commit_sha / index freshness). Use action:"list" when the repo slug is unknown; searches accept a known slug directly or default to your key's single repo.
- [ask_maguyva](https://maguyva.ai/ar/docs/mcp-api#ask-maguyva): Get Maguyva tool guidance, or submit a bug report / feature request stored for Maguyva's maintainers. Never include secrets or sensitive personal data in feedback.

## الخطوات التالية

- [البدء السريع](https://maguyva.ai/ar/docs/quickstart)
- [دليل التثبيت](https://maguyva.ai/ar/docs/installation)
- [مرجع MCP API](https://maguyva.ai/ar/docs/mcp-api)
- [استكشاف الأخطاء](https://maguyva.ai/ar/docs/troubleshooting)
- [كيف يعمل](https://maguyva.ai/ar/docs/how-it-works)
- [التوافق والمواصفات التقنية](https://maguyva.ai/ar/docs/compatibility)

## Agent integrations

- [Maguyva لـCursor: سياق قاعدة الكود عبر MCP](https://maguyva.ai/ar/for-cursor): Cursor يحرِّر الملف المفتوح؛ Maguyva تفهرس المستودع الموحّد بأكمله وتعيده عبر MCP — بحث دلالي وAST ورسم بياني ونصي مع file:line، ليجد الوكيل الملفات التي لم تثبّتها.
- [Maguyva لـWindsurf: سياق قاعدة الكود عبر MCP](https://maguyva.ai/ar/for-windsurf): ‏Windsurf وCascade يحرِّران الملف المفتوح؛ Maguyva تفهرس المستودع الموحّد بأكمله وتعيده عبر MCP — بحث دلالي وAST ورسم بياني ونصي مع file:line، ليجد Cascade الملفات التي لم تذكرها.
- [Maguyva لـAntigravity: سياق قاعدة الكود عبر MCP](https://maguyva.ai/ar/for-antigravity): تُشغِّل Antigravity وكلاء مستقلين عبر المحرِّر والطرفية والمتصفح؛ تمنحهم Maguyva خريطة قابلة للاستعلام عن المستودع الموحّد عبر MCP — نطاق التأثير مسبقًا، لا بعد أن يتحوّل CI إلى الأحمر.
- [Maguyva لـCodex: سياق قاعدة الكود عبر MCP](https://maguyva.ai/ar/for-codex): ملف AGENTS.md هو اتفاقية العمل. Maguyva هو خادم MCP الذي يمنح Codex CLI خريطة قابلة للاستعلام للمستودع، حتى لا يكون التعديل الأول تخميناً.
- [Maguyva لأي عميل MCP: سياق قاعدة الكود عبر MCP](https://maguyva.ai/ar/for-anything): MCP بروتوكول مفتوح. وMaguyva خادم MCP قياسي، لذا يحصل العملاء الداعمون لـMCP مثل Claude Code, Codex CLI, Gemini CLI, Cursor, Windsurf, Antigravity على سياق قاعدة الكود نفسه المستند إلى الكود الفعلي.
- [Maguyva لـGemini CLI: سياق قاعدة الكود عبر MCP](https://maguyva.ai/ar/for-gemini): ‏GEMINI.md يضبط سياق العمل؛ MCP هو القناة. Maguyva هي خادم MCP الذي يمنح Gemini CLI خريطة قابلة للاستعلام عن مستودعك — بحث دلالي وAST ورسم بياني بحيث لا يكون التعديل الأول تخمينًا.
- [Maguyva لـClaude Code: سياق قاعدة الكود عبر MCP](https://maguyva.ai/ar/for-claude-code): يخبر ملف CLAUDE.md نموذج Claude بكيفية التصرف. تفهرس Maguyva المستودع وتقدّمه عبر MCP لكي يحرّر Claude Code استناداً إلى خريطة قابلة للاستعلام.
- [Maguyva لـ GitHub Copilot CLI: سياق الكود عبر MCP](https://maguyva.ai/ar/for-copilot): تخبر التعليمات المخصصة Copilot بكيفية التصرف. تفهرس Maguyva المستودع وتقدّمه عبر MCP لكي يحرّر GitHub Copilot CLI استناداً إلى خريطة.

## Company

- [حول Maguyva: ذكاء الكود عبر MCP](https://maguyva.ai/ar/about): ذكاء الكود للعملاء البرمجيين: بحث دلالي وبنيوي (AST) وبياني ونصي كامل، والبحث عن الرموز، وتحليل التبعيات، وسياق المهام بطلب واحد عبر أكثر من 284 لغة.
- [تعرّف على الفريق: إنسانان + سرب من وكلاء الذكاء الاصطناعي](https://maguyva.ai/ar/team)
- [كيف نعمل: بلا رأس مال استثماري، بلا تسعير لكل مقعد، بلا بوابات ميزات](https://maguyva.ai/ar/how): بلا رأس مال خارجي. بلا تسعير لكل مقعد. بياناتك ليست المنتج. كيف بُني Maguyva ولماذا يُسعَّر بهذه الطريقة.
- [المكدس التقني: PostgreSQL، وTree-sitter، وMCP](https://maguyva.ai/ar/stack): المكدس التقني الذي يشغّل Maguyva. PostgreSQL، وتضمينات Voyage AI، والبحث المتجهي المكمَّم، وشجرة AST لـTree-sitter، وبروتوكول MCP.
- [سجل التغييرات](https://maguyva.ai/ar/changelog): ما صدر في Maguyva: تغييرات المنتج، تحديثات الفهرس وأدوات MCP، وملاحظات من عملية البناء. الأحدث أولاً.
- [مباشر: Maguyva يبني نفسه، في الوقت الفعلي](https://maguyva.ai/ar/live): لا عرض توضيحي مُعد سلفًا. هذا سجل الإرسال الفعلي — كل استدعاء أداة، وخلل، وcommit، من فريق وكلاء الذكاء الاصطناعي الذي يبني Maguyva، مباشرة.

## Guides

- [ليس بحثًا نصيًا كاملاً يرتدي معطفًا طويلاً. بل خمسة أنماط استرجاع مدمجة.](https://maguyva.ai/ar/beyond-rag): الشيفرة تحتاج إلى أكثر من مقاطع دلالية. يدمج Maguyva خمسة أنماط استرجاع في إجابة واحدة مرتَّبة، مرتكزة على المستودع الفعلي عبر MCP، ضمن 284 لغة. فئة Free، دون بطاقة.
- [ملفات التوجيهات ليست خريطة لشيفرتك. أما Maguyva فهو كذلك.](https://maguyva.ai/ar/beyond-rules-files): يخبر CLAUDE.md وAGENTS.md الوكيل كيف يتصرّف. لكنهما لا يخبرانه بما تحتويه قاعدة الشيفرة. Maguyva هو طبقة سياق قاعدة الشيفرة عبر MCP، ضمن 284 لغة. فئة Free، دون بطاقة.
- [التعديل سهل. أما معرفة ما يتعطّل فصعبة. Maguyva يرسم ذلك.](https://maguyva.ai/ar/know-what-breaks): قبل إعادة الهيكلة، ينبغي لوكيلك أن يعرف كل مستدعٍ، ومستورِد، وتابع. يجيب Maguyva عن ذلك من رسم الاستدعاء الفعلي عبر MCP، لا من grep. فئة Free، دون بطاقة.
- [ابدأ مجانًا: طبقة سياق قاعدة الشيفرة لوكلاء البرمجة بالذكاء الاصطناعي](https://maguyva.ai/ar/map-then-change): الخريطة أولًا. التغيير ثانيًا. يمنح Maguyva وكيل البرمجة بالذكاء الاصطناعي لديك خريطة قابلة للاستعلام لقاعدة الشيفرة عبر MCP، قبل أول تعديل. 11 أداة عبر 284 لغة. فئة Free، دون بطاقة.
- [وكيلك يبدأ أعمى على مستودعك. Maguyva يمنحه خريطة.](https://maguyva.ai/ar/stop-flying-blind): يفحص وكلاء البرمجة الملفات الخاطئة ويعدّلونها قبل أن يفهموا الشيفرة. يمنح Maguyva وكيلك خريطة قابلة للاستعلام لقاعدة الشيفرة عبر MCP، ضمن 284 لغة. فئة Free، دون بطاقة.