عمليات الأعمالالمصدر العام

Ads MCP Server

منصة إعلانات رقمية لوكلاء مبيعات وتسويق ADK-Rust Enterprise. 19 أداة MCP تغطي الحملات، مجموعات الإعلانات، الإعلانات/الإبداعات، الميزانيات والعروض، الجماهير، مقاييس الأداء اليومية مع مؤشرات الأداء المشتقة…

افتح المصدر اقرأ الدليل الرسمي ↗

ما الذي يقدمه للوكيل

قدرة مخصصة خلف اتصال MCP واحد.

يمتلك الخادم منطق مجاله وينشر عقد أداة يمكن لعميل MCP اكتشافه. يمكن لـ ADK-Rust تحميل هذا العقد في وكيل، تطبيع كل مخطط لمزود النموذج المختار، والحفاظ على دورة حياة الاتصال خارج منطق عمل الوكيل.

هيكل الحملة — الحملات (الهدف، القناة، الميزانية اليومية) → مجموعات الإعلانات (استراتيجية العرض + العرض/الهدف، الجمهور) → الإعلانات/الإبداعات.

الجماهير — الاهتمام / إعادة التسويق / الشبه / مخصص مع الحجم المقدر.

المقاييس ومؤشرات الأداء — استيعاب الانطباعات/النقرات/الإنفاق/التحويلات/الإيرادات اليومية؛ مؤشرات CTR, CPC, CPA, CVR, ROAS على مستوى مجموعة الإعلان والحملة المجمعة.

توقيت الميزانية — الإنفاق اليوم مقابل الميزانية اليومية مع علامة التوقيت (إنفاق منخفض / على المسار / توقيت مرتفع / استنفاد الميزانية).

التحسين — اقتراحات قائمة على القواعد لكل مجموعة إعلانات: تكبير الفائزين ذوي ROAS العالي، قطع/إيقاف المجموعات دون نقطة التعادل أو بدون تحويلات، تمييز CTR المنخفض، والتقاط CPA الذي يتجاوز الهدف…

البنية

كيف يتناسب Ads MCP Server مع نظام الوكيل.

لا يحتاج النموذج أبدًا إلى تفاصيل التنفيذ أو بيانات اعتماد النظام خلف الخادم. يرى تعريفات الأدوات المراجعة. يتولى عميل MCP الاكتشاف والاستدعاءات، بينما يحتفظ الخادم بملكية التحقق، السياسة، والاتصال بنظام مجاله.

وكيل ADK-Rust

يختار قدرة من كتالوج الأدوات المراجعة.

→

عميل MCP

يكتشف المخططات، يرسل الاستدعاءات، ويتلقى المحتوى المطبوع.

→

Ads MCP Server

يحقق في الطلب ويمتلك 19 عقود أدوات موثقة.

→

نظام المجال

يحافظ على واجهة برمجة التطبيقات، البيانات، بيانات الاعتماد، وقواعد العمل خلف الخادم.

الاتصال: stdio · إطار عمل الخادم: ADK MCP SDK + rmcp

مخطط هيكلية Ads MCP Server من مستودعه الرسمي

كتالوج الأدوات

ماذا يمكن للوكيل أن يطلب من Ads MCP Server القيام به؟

لكل أداة اسم ثابت، غرض قابل للقراءة من قبل الإنسان، وعقد إدخال JSON يتم اكتشافه أثناء تهيئة MCP. تأتي فئات المخاطر من بيان سجل المشروع عند توفره.

19 أدوات مسماة

create_campaign

إنشاء حملة (مسودة)

internal write

get_campaign

الحصول على حملة بواسطة المعرف

read only

list_campaigns

قائمة الحملات حسب الحالة/القناة

read only

set_campaign_status

تعيين حالة الحملة (تؤثر على الإنفاق) — مقيدة

external write

set_budget

تعيين الميزانية اليومية للحملة — مقيدة (الإنفاق)

external write

create_ad_group

إنشاء مجموعة إعلانات تحت حملة

internal write

get_ad_group

الحصول على مجموعة إعلانات بواسطة المعرف

read only

list_ad_groups

قائمة مجموعات الإعلانات في حملة

read only

set_bid

تعيين عرض/هدف مجموعة إعلانات — مقيد (الإنفاق)

external write

create_ad

إنشاء إعلان/إبداع

internal write

list_ads

قائمة الإعلانات في مجموعة إعلانات

read only

create_audience

إنشاء جمهور

internal write

الحوكمة

افهم تأثير كل أداة.

يرث اتصال الخادم سلطة بيانات الاعتماد وبيئة النشر الخاصة به. التصريحات أدناه مأخوذة من ملف README الخاص بهذا المشروع وبيان سجل MCP؛ لا يزال تطبيقك يقرر الأدوات التي يتلقاها الوكيل وأين يتطلب الأمر الموافقة.

11 read only5 internal write3 external write

ثلاث عمليات كتابة تؤثر مباشرة على الإنفاق ومقيدة (يتطلب_موافقة، كتابة_خارجية): set_budget, set_bid, و set_campaign_status (إيقاف/تفعيل الحملة يؤثر على الإنفاق).…
optimize للقراءة فقط — يقدم توصيات؛ تطبيق التوصية يتم عبر أداة مقيدة. الميزانيات والعروض محمية من السلبية؛ الحملات المنتهية نهائية.
كل المواد مغطاة بسجل التدقيق (audit_log). البيانات النموذجية وهمية.

واجهة MCP

ما تعلنه الوثائق الحالية.

يمكن لـ MCP حمل الأدوات، الموارد، المطالبات، النتائج المنظمة، التقدم، الإلغاء، والعمل طويل الأمد. يبرز هذا السجل ميزات البروتوكول الحديثة المذكورة صراحة في هذا المستودع.

يركز README الحالي على واجهة الأدوات الخاصة به. تحقق من المصدر وملاحظات الإصدار قبل الاعتماد على قدرات MCP الاختيارية بخلاف اكتشاف الأدوات واستدعائها.

ADK MCP SDKrmcpبيان السجل

التثبيت والاتصال

اتبع نقطة البداية الموثقة للمشروع.

ثبت الخادم في البيئة التي تمتلك بيانات الاعتماد والوصول إلى المجال. أضفه إلى مضيف MCP الخاص بك، تحقق من الأدوات المكتشفة، وقم بتضييق مجموعة الأدوات قبل تسليمها لوكيل الإنتاج.

تثبيت

cargo install mcp-ads

شكل اتصال ADK-Rust

let toolset = McpToolset::from_stdio(
    "mcp-ads",
    ["mcp-ads"],
).await?;

let agent = LlmAgentBuilder::new("agent")
    .tools(toolset.tools().await?)
    .build()?;

يتم استخراج الأوامر والتكوين من ملف README العام. تحقق من المتطلبات المسبقة، متغيرات البيئة، وخيارات الإصدار المحددة في الوثائق الرسمية قبل النشر.

الوثائق الرسمية

تابع مصدر الحقيقة الخاص بصانعي المشروع.

توفر هذه الصفحة خريطة سهلة الوصول للخادم. يبقى المستودع المرجع الدقيق للمخططات، المتطلبات المسبقة، التكوين، الأمثلة، الاختبارات، الإصدارات، وتحديثات الأمان.

نظرة عامة ↗README.md سجل التغييرات ↗CHANGELOG.md الهيكلية ↗docs/architecture.svg المشكلات والدعم ↗مشكلات github.com

استمر في الاستكشاف

Ads MCP Server

قدرة مخصصة خلف اتصال MCP واحد.

كيف يتناسب Ads MCP Server مع نظام الوكيل.

وكيل ADK-Rust

عميل MCP

Ads MCP Server

نظام المجال

الهيكلية المنشورة للخادم

ماذا يمكن للوكيل أن يطلب من Ads MCP Server القيام به؟

افهم تأثير كل أداة.

ما تعلنه الوثائق الحالية.

اتبع نقطة البداية الموثقة للمشروع.

تابع مصدر الحقيقة الخاص بصانعي المشروع.

المزيد في عمليات الأعمال.