Skip to main content
Glama

Dastyar CMS V3 — Autonomous MCP Server

License: MIT MCP Version Status: Production Ready

سرور جامع و رسمی Model Context Protocol (MCP) برای مدیریت کامل پنل ادمین دست اول و دستیار نسخه ۳ (v3.dastyar.io) و سرویس‌های کاربردی زنده دستیار (api.dastyar.io).

این سرور به دستیاران هوش مصنوعی (Antigravity, Claude Desktop, Cursor, Windsurf) امکان می‌دهد تا مستقیماً به ۵۳ موجودیت CMS، سیستم رویدادها، کمپین‌های تبلیغاتی آستین، نوتیفیکیشن‌ها و توست‌ها، ویجت‌های دم‌دستی، بوکمارک‌های پین‌شده، والپیپرها و داده‌های زنده مالی و آب‌وهوا دسترسی داشته باشند و عملیات Read و Write را با احراز هویت پایدار انجام دهند.


🌟 قابلیت‌های کلیدی (Key Features)

  • 🚀 دسترسی کامل خواندن و نوشتن (Full Read & Write): ساخت، ویرایش و حذف انواع رویدادهای تقویمی، نوتیفیکیشن‌های توست با آپلود تصویر به S3، کدهای تخفیف و مدیریت کاربران پلاس.

  • 🔐 معماری احراز هویت چندلایه خودکار (Zero-Touch 4-Tier Auth):

    • استخراج خودکار سشن بدون کلیک از مرورگرهای در حال اجرا (Chrome, Brave, Arc, Edge, Safari).

    • رابط وب لوکال ۱-کلیک در localhost:48215 با پشتیبانی از خواندن کلیپ‌بورد، فرم ادمین و پیامک OTP.

    • بریج اختصاصی در پورت ۴۸۲۲ برای اتصال سریع از کنسول مرورگر.

    • ذخیره‌سازی امن با سطح دسترسی 0600 در ~/.dastyar-session.json همراه با تمدید خودکار (Auto-Renewal) در پس‌زمینه.

  • ⚡ بیش از ۶۰ ابزار عملیاتی تخصصی: پوشش ۱۰۰٪ قابلیت‌های بک‌آفیس کی‌استون و ای‌پی‌آی‌های عمومی دستیار.

  • 🎯 تفکیک دقیق صفحات و شلف‌ها: تمایز دقیق میان بخش «دم دستی» (damedasti) و بخش «دست اول» (dasteaval).


Related MCP server: magento-mcp-server

📦 نحوه نصب و راه‌اندازی (Installation & Setup)

۱. نصب سریع از گیت‌هاب (Quick Clone)

git clone https://github.com/Hesvm/dastyar-cms-v3.git
cd dastyar-cms-v3
npm install

۲. بررسی وضعیت نشست و احراز هویت

# بررسی وضعیت احراز هویت و اتصال به دیتابیس زنده
npm run status

# باز کردن رابط وب ۱-کلیک ورود در مرورگر
npm run login:browser

# منوی تعاملی کنسول ترمینال
npm run login

⚙️ پیکربندی در کلاینت‌های هوش مصنوعی (MCP Configuration)

برای Antigravity / Claude Desktop

فایل تنظیمات claude_desktop_config.json یا تنظیمات MCP در Antigravity را باز کرده و بخش زیر را اضافه کنید:

{
  "mcpServers": {
    "dastyar-cms-v3": {
      "command": "node",
      "args": [
        "/Users/hesam/.gemini/antigravity/scratch/dastyar-mcp/bin/cli.js"
      ],
      "env": {
        "DASTYAR_V3_URL": "https://v3.dastyar.io",
        "DASTYAR_API_URL": "https://api.dastyar.io"
      }
    }
  }
}

برای Cursor IDE

در بخش Settings -> Features -> MCP Servers یک سرور جدید با مشخصات زیر تعریف کنید:

  • Type: command

  • Command: node /مسیر/پروژه/dastyar-cms-v3/bin/cli.js


🛠️ فهرست جامع ابزارها (Tools Catalog)

۱. ابزارهای احراز هویت و سشن (Auth & Session)

نام ابزار

توضیحات

dastyar_auto_auth

استخراج خودکار و بدون کلیک سشن از مرورگرهای در حال اجرا

dastyar_start_browser_login

راه‌اندازی رابط وب ۱-کلیک در localhost:48215 و باز کردن مرورگر

dastyar_auth_status

نمایش وضعیت جامع نشست ادمین و تست ارتباط با سرور زنده

dastyar_admin_login

ورود مستقیم ادمین با ایمیل و رمز عبور در کی‌استون

dastyar_update_session

ثبت یا به‌روزرسانی دستی کوکی یا توکن

dastyar_user_request_otp

ارسال پیامک کد تأیید برای ورود کاربر

dastyar_user_verify_otp

اعتبارسنجی کد پیامکی و ذخیره توکن کاربر

۲. مدیریت رویدادها و تقویم (Events)

نام ابزار

توضیحات

dastyar_admin_get_events

دریافت لیست رویدادها همراه با تاریخ، پیوند و تعداد کل

dastyar_admin_create_event

ایجاد رویداد جدید با عنوان فارسی، عنوان انگلیسی و بازه زمانی

dastyar_admin_update_event

ویرایش عنوان، تاریخ‌ها یا لینک رویداد موجود با شناسه

dastyar_admin_delete_event

حذف رویداد تقویمی با شناسه

۳. نوتیفیکیشن‌ها و پیام‌های توست (Toast & In-App Notifications)

نام ابزار

توضیحات

dastyar_admin_get_notifications

دریافت لیست نوتیفیکیشن‌های فعال، زمان‌بندی و آیکون‌ها

dastyar_admin_create_notification

ساخت نوتیف توست با آپلود تصویر به S3، مقصد دم‌دستی (damedasti) و اتصال به ویجت

dastyar_admin_delete_notification

حذف نوتیفیکیشن با شناسه

۴. تبلیغات آستین، مسکات‌ها و بوکمارک‌ها (Astin Ads & Bookmarks)

نام ابزار

توضیحات

dastyar_admin_get_astin_ad_events

لیست کامل کمپین‌ها و رویدادهای تبلیغاتی آستین

dastyar_admin_get_astins

لیست کاراکترها و مسکات‌های فعال آستین

dastyar_admin_get_pinned_bookmarks

بوکمارک‌های رسمی پین‌شده روی دسکتاپ دستیار

dastyar_admin_get_suggested_websites

وب‌سایت‌های پیشنهادی و کتگوری‌های دستیار

۵. ویجت‌ها، اپلیکیشن‌ها و تصاویر پس‌زمینه (Widgets & Wallpapers)

نام ابزار

توضیحات

dastyar_admin_get_widgets

لیست تمام ویجت‌های دسکتاپ (کریپتو، طلا، ترجمه و ...)

dastyar_admin_get_damdasti_apps

اپلیکیشن‌ها و ابزارهای بخش دم‌دستی

dastyar_admin_get_wallpapers

کتابخانه والپیپرهای دستیار با اطلاعات عکاس

dastyar_admin_get_shelves

شلف‌ها و دسته‌بندی‌های موضوعی (کریپتو، اخبار، سرگرمی)

dastyar_admin_get_sidebar_badges

بج‌ها و نشان‌های نوار کناری

۶. کاربران، سطوح عضویت و کدهای تخفیف (Users & Subscriptions)

نام ابزار

توضیحات

dastyar_admin_users_list

جستجو، فیلتر و صفحه‌بندی کاربران دستیار

dastyar_admin_user_apply_plus

ارتقای حساب کاربری به اشتراک پلاس با تعداد روز دلخواه

dastyar_admin_users_apply_plus_batch

ارتقای دسته‌ای کاربران به پلاس

dastyar_admin_discount_codes

مشاهده کدهای تخفیف فعال و استفاده‌شده

dastyar_admin_create_discount_code

ساخت کد تخفیف جدید با درصد و ظرفیت

dastyar_admin_delete_discount_code

حذف کد تخفیف با شناسه

۷. سرویس‌های زنده دستیار (Live Assistant Utilities)

نام ابزار

توضیحات

dastyar_get_financial_prices

قیمت زنده طلا، سکه، ارزها، رمزارزها و بورس به تومان با تغییرات ۲۴ ساعته

dastyar_get_weather

وضعیت آب و هوا، پیش‌بینی ساعتی و هفتگی و شاخص UV

dastyar_get_prayer_times

اوقات شرعی دقیق اذان‌ها، طلوع و غروب برای تمامی شهرهای ایران

dastyar_list_cities

جستجو در میان بیش از ۶۵۰ شهر ایران با مختصات جغرافیایی

dastyar_get_timezones

لیست مناطق زمانی دنیا با اختلاف ساعت GMT

dastyar_get_hijri_calendar

تقویم هجری قمری و وضعیت رویت هلال ماه


🧪 آزمون زنده (Live Test Suite)

این سرور مجهز به سیستم ممیزی بدون ماک (Zero-Mock Audit) است که مستقیماً اندپوینت‌های واقعی را ارزیابی می‌کند:

npm run audit

خروجی تست ممیزی:

🔍 Starting Zero-Mock Live Tool Audit for [Dastyar MCP Server]...
• Testing Admin Keystone GraphQL Status            ✅ PASS
• Testing Live Financial Prices (Gold/Forex/Crypto) ✅ PASS
• Testing Live Weather (Tehran)                    ✅ PASS
• Testing Live Prayer Times (Oghat Tehran)         ✅ PASS
• Testing Cities Directory Search (شیراز)          ✅ PASS
• Testing Global Timezones List                    ✅ PASS
• Testing Hijri Lunar Calendar (Hilal)             ✅ PASS
• Testing User Data Access Guardrail Check         ✅ PASS
=====================================================
📊 Audit Summary: 8/8 Passed (100% Pass Rate)
=====================================================

📄 لایسنس (License)

این پروژه تحت مجوز MIT منتشر شده است. کتگوری: توسعه‌یافته برای اکوسیستم هوش مصنوعی دستیار. سازنده: Hesam Mousavi (@Hesvm)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to manage Magento 2 / Adobe Commerce products, stock, orders, and customers through 12 read/write MCP tools with secure, audited access.
      AGPL 3.0
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to build and update complete applications, including creating, updating, publishing, previewing, and configuring databases, security, permissions, and server-side integrations.
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to operate Shopify stores through 61 risk-tiered tools for store operations, SEO and GEO audits, deterministic analytics, inventory intelligence, feed quality, and safe marketing workflows. It defaults to read-only access and uses previews, bound approvals, and audit logging for writes.
      1
      MIT