أدوات MCP

كل أداة ومورد وموجّه (prompt) يتيحه خادم MCP في LaRecipe. وما يراه المستدعي يعتمد على الخادم والمجموعة وهوية المستدعي. لتوصيل وكيل، راجع خادم MCP.

الأدوات التي يتيحها كل خادم

لا تتيح مجموعة المستودع أدوات التأليف على الويب أبدًا. وكل نقطة نهاية على الويب مرتبطة بمجموعتها: الاستدعاء الذي يسمّي مجموعة أخرى في set يُرفض. والزائر على نقطة النهاية في هذا الموقع يرى أربع أدوات: search_docs و read_page و list_pages و submit_feedback. والإعدادات تحت mcp في مرجع الإعدادات.

أدوات القراءة

تحمل الأدوات الثلاث التوصيفات readOnlyHint: true و idempotentHint: true و openWorldHint: false. وعلى الخادم المحلي تأخذ كل منها أيضًا set (string): مجموعة التوثيق المستخدمة، وقيمتها الافتراضية larecipe.default.

search_docs

Search the documentation and get the best matching pages, with the section and a snippet for each. Search before you read or write a page. Pass a result's path to read_page to read it.

تُعيد نتائج منظّمة: set و version و query و results، ولكل نتيجة title و path و url و markdown_url و heading و snippet و description و score.

read_page

Read one docs page as Markdown. Pass the path from search_docs or list_pages (for example "guides/webhooks"), or the page URL. Pass section (a heading or its #anchor) to read only that part of the page. The result ends with the page's content_hash (also in its _meta): pass it as based_on when you write, move or delete the page.

تُعيد نسخة Markdown للوكلاء من الصفحة، مع title و path و version و locale و url و markdown_url و content_hash في _meta من النتيجة. وينتهي النص بسطر يحمل content_hash نفسه، للعملاء الذين يعرضون النص فقط. ويحصل Ask AI على Markdown من دون ذلك السطر.

list_pages

List the docs as the navigation shows them: groups, then pages with their title, path and description. Pass group to list one group only. Read a page with read_page and its path.

الملاحظات

submit_feedback

Tell the docs owners whether a page helped. Use it when a page was wrong, outdated or missing something you needed, and say what in the comment.

التوصيفات: readOnlyHint: false و destructiveHint: false و idempotentHint: false و openWorldHint: false. وعلى الخادم المحلي تأخذ أيضًا set.

تطلق الحدث FeedbackSubmitted مع ضبط source على agent. ولا يخزّن LaRecipe شيئًا. راجع الأحداث.

التحقق

validate_docs

Check the docs for broken links and anchors, navigation entries without pages, schema errors in larecipe.json, navigation.json and frontmatter, unknown components, missing snippets and more. Run it after writing, and fix every error. Each issue has a stable rule id and often a fix.

التوصيفات: readOnlyHint: true و idempotentHint: true و openWorldHint: false.

تُعيد التقرير نفسه الذي يُخرجه php artisan larecipe:validate --json.

أدوات التأليف

تغيّر أدوات التأليف التوثيق: الملفات في شجرة العمل في مجموعة المستودع، أما في مجموعة قاعدة البيانات فقاعدة البيانات المحلية مع ترحيل التوثيق الخاص بالفرع. وتُعيد كل منها outcome (published أو drafted أو conflicted أو unchanged أو rejected) و message و revision و validation و docs_migration.

كل أداة تأليف تحمل التوصيف destructiveHint: true، وتأخذ هذه الوسائط إلى جانب وسائطها الخاصة:

من أين تأتي based_on:

• write_page و move_page و delete_page: قيمة content_hash التي أعادتها read_page للصفحة. احذفها لصفحة جديدة.
• update_navigation و update_manifest: قيمة revision.content_hash التي أعادها آخر استدعاء لك للأداة نفسها (وفي التنقل، لذلك الإصدار وتلك اللغة). احذفها لتغيّر التنقل أو ملف التعريف كما هو الآن.

تحمل revision التي تعيدها كل أداة تأليف القيمة content_hash، أي بصمة ما كتبته، فيستطيع الوكيل أن يسلسل عدة تغييرات على الصفحة نفسها.

write_page

Create or replace one docs page: frontmatter and Markdown body. Read the page first with read_page and pass the content_hash it returns as based_on, so you never overwrite a newer edit (leave based_on out for a new page). On a repository set the file changes in the working tree; on a database set the change is applied to the local database and written into the branch's docs migration (commit it with the code). Returns the revision and the validation result; fix every validation error it reports.

move_page

Move one docs page to another path (or version, or locale) in the same set. Refused when the new path is taken. Update links and the navigation afterwards (update_navigation with a rename patch). Pass the content_hash read_page returned as based_on.

delete_page

Delete one docs page. Remove it from the navigation too (update_navigation with a remove patch). On a database set the page stays in the revision history and can be restored. Pass the content_hash read_page returned as based_on.

update_navigation

Change the navigation (navigation.json) of one version: send a whole tree, or a patch, a list of operations such as {"add": "billing/exports", "group": "Billing", "after": "billing/overview"}, {"move": "a", "group": "B"}, {"remove": "a"} or {"rename": "a", "to": "b"}. A version without navigation.json starts from the navigation derived from its folders.

update_manifest

Change the set's larecipe.json (name, description, theme, versions, locales, navbar, redirects, agent description) with a JSON merge patch: keys replace, null removes a key, objects merge, lists are replaced whole. Presentation and structure only: routes, drivers, AI settings and secrets live in config/larecipe.php and never here, and so do a database set's analytics integrations.

affected_pages

List the docs pages whose sources: match files changed between base (default: the default branch) and head, plus uncommitted work. Each page says whether the change already updated it (status "updated") or left it stale (status "stale"). Update stale pages before you push.

للخادم المحلي فقط: تقرأ شجرة العمل لديك و git، فلا تقدّمها أي نقطة نهاية على الويب. تحمل التوصيف readOnlyHint: true، ولا تأخذ إلا وسائطها الخاصة:

هي الفحص نفسه الذي يجريه larecipe:affected.

الموارد

يقدّم الخادم القالب فقط، و resources/list فارغة. ونقطة نهاية الويب لا تقرأ إلا صفحات مجموعتها.

الموجّهات

التعليمات عند الاتصال

يحصل كل عميل على سير العمل نفسه عند الاتصال: ابحث أولًا بـ search_docs، واقرأ قبل الكتابة بـ read_page، وتحقّق بعد الكتابة بـ validate_docs، واستشهد بروابط الصفحات، واستخدم submit_feedback حين تكون صفحة خاطئة أو ناقصة. ومع وجود عدة مجموعات، يسردها الخادم المحلي أيضًا. ويعرض خادم MCP النص الكامل.

التالي

• خادم MCP: وصّل وكيلًا، وصادِق على مجموعة خاصة.
• الأحداث: McpToolCalled و SearchPerformed و FeedbackSubmitted.