Skip to main content
Glama
README.md
# Dastyar CMS V3 — Autonomous MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![MCP Version](https://img.shields.io/badge/MCP-1.1.0-emerald.svg)](https://modelcontextprotocol.io)
[![Status: Production Ready](https://img.shields.io/badge/Status-Production%20Ready-brightgreen.svg)]()

سرور جامع و رسمی **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`).

---

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

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

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

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

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

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

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

---

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

### برای Antigravity / Claude Desktop

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

```json
{
  "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) است که مستقیماً اندپوینت‌های واقعی را ارزیابی می‌کند:

```bash
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)](https://github.com/Hesvm)