Dastyar CMS V3
by Hesvm
README.md
# Dastyar CMS V3 — Autonomous MCP Server
[](LICENSE)
[](https://modelcontextprotocol.io)
[]()
سرور جامع و رسمی **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)
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues