CasioPlus MCP

MCP server برای اکوسیستم دانش و عملیات کاسیو‌پلاس
CasioPlus MCP Server for the Casio Plus knowledge-and-operations ecosystem

CasioPlus MCP یک سرور Model Context Protocol (MCP) است که مدل دانش، متدولوژی و دارایی‌های کاسیو‌پلاس را به ابزارهای هوش مصنوعی، عامل‌ها و هر رابط عملیاتیِ موردنیاز کاسیو متصل می‌کند.

این ریپو فورک FounderOS نیست و توپولوژی یا معماری کاسیو را از آن به ارث نمی‌گیرد. FounderOS صرفاً یک نمونهٔ الهام‌بخش است: نشان می‌دهد که یک نفر می‌تواند با یک UI ساده، دادهٔ ساختاریافته، Repository Layer، Agentها و اتصال‌های صادقانه، یک سیستم متناسب با نیاز خودش بسازد.

ما نیز همین اصل را برای کاسیو اجرا می‌کنیم: یک سیستم ساده، بومی، مرحله‌ای و دقیقاً منطبق با نیازهای خود کاسیو. نقش MCP یک لایهٔ توانمندساز است؛ دانشِ معتبر را بازیابی می‌کند، ساختار و کیفیت داده را بررسی می‌کند، و بازخورد عملیات را بدون آلودن مستقیم هستهٔ دانش به صف بررسی وارد می‌کند.

اصل معماری

Casio Knowledge Core                    CasioPlus MCP                  Clientهای مجاز کاسیو
────────────────────                    ─────────────                  ─────────────────────
کاسیو.yaml + Markdown       →       Tools / Resources / Prompts   →   AI / CLI / UI سبک
پلی‌بوک / رجیستری / SOP              Validation / Retrieval            فقط در صورت نیاز
منبع حقیقت دانش                       Controlled feedback intake              │
        ↑                                                                         │
        └──── Review + approval ← Feedback Intake Queue ←────────────────────────┘

قانون غیرقابل‌مذاکره

• Knowledge Core منبع حقیقت است. در نسخهٔ اولیه: knowledge/casio.yaml و Markdownهای ساختاریافته.

• MCP لایهٔ دسترسی و کنترل است. نه منبع حقیقت دوم.

• Casio Operator لایهٔ تعامل و عملیات است. نه محل ساخت دانش سازمانی.

• بازخورد عملیاتی با write مستقیم وارد مدل دانش نمی‌شود؛ ابتدا اعتبارسنجی، صف‌بندی، بررسی انسانی و سپس ادغام نسخه‌ای می‌شود.

Related MCP server: cortex-brain

مسئله‌ای که حل می‌کند

کاسیو‌پلاس هم‌اکنون شامل این مؤلفه‌هاست:

• ۵۶ پلی‌بوک و راهنمای اجرایی، با مالک، سطح HEGAM، وابستگی و مسیر بازگشت داده؛

• ۱۰ مستند عملیاتی واقعی؛

• ۶ زیرسیستم: زیرساخت دانش، فروش و بازاریابی، محتوا و کانال بله، آموزش و کوچینگ، پایش و ارزیابی، اکوسیستم و مشارکت رشد؛

• برنامهٔ ۹ جلسه‌ای، ۸ نقش استاندارد و ۶ قالب دارایی؛

• مدل Casio Metric، کوچینگ، سفیران، مشارکت رشد و Data Cleaning Gate.

بدون یک Gateway، عامل‌ها و داشبوردها یا به دادهٔ خام و پراکنده متصل می‌شوند، یا نسخه‌های متفاوتی از «حقیقت» می‌سازند. CasioPlus MCP این مرز را استاندارد می‌کند.

اصول طراحی CasioPlus

1. Need-first، نه framework-first: هیچ قابلیت فقط چون FounderOS یا ابزار دیگری دارد وارد محصول نمی‌شود؛ هر قابلیت باید یک مسئلهٔ واقعی کاسیو، مالک، خروجی و مسیر بازگشت داده داشته باشد.

2. ساده‌ترین برش قابل استفاده: ابتدا کوچک‌ترین Tool/Resource MCP که یک کار واقعی را حل می‌کند؛ نه داشبورد یا معماری بزرگ پیش از نیاز.

3. توپولوژی کاسیو ثابت می‌ماند: MCP به هستهٔ دانش و معماری HEGAM خدمت می‌کند؛ آن را جایگزین یا بازچینی نمی‌کند.

4. دانش قبل از اتوماسیون: تا وقتی پلی‌بوک، مدل داده، مالک و معیار پذیرش روشن نشده، اتوماسیون ساخته نمی‌شود.

5. Read-first، Write-guarded: بازیابی دانش کم‌ریسک است؛ نوشتن، انتشار یا اجرای عملیات نیازمند گیت کیفیت، مجوز و ردپای ممیزی است.

6. Scale to reality: ابزار فقط به اندازهٔ پیچیدگی واقعی کاسیو رشد می‌کند؛ از YAML/Markdown شروع می‌کند و تنها هنگام نیاز به DB، Queue، RBAC یا UI بزرگ‌تر ارتقا می‌یابد.

دامنهٔ نسخهٔ اول (MVP)

منابع MCP (Resources)

ابزارهای MCP (Tools)

Promptهای MCP

Data Quality Gate

هر دادهٔ بیرونی قبل از ورود به feedback_intake از این گیت عبور می‌کند:

raw → validate → quarantined / rejected / validated → review → approved → versioned knowledge change

وضعیت کیفیت هر رکورد:

quality_status: raw | quarantined | validated | rejected

مدل دسترسی پیشنهادی

نسخهٔ محلی می‌تواند با stdio و بدون شبکه اجرا شود. در استقرار شبکه‌ای، Shared Token فورک FounderOS برای کاسیو کافی نیست.

اصل امنیتی: Agentها در فاز اول فقط read و recommend دارند. هر اقدام حساس (ارسال پیام، تغییر CRM، انتشار محتوا، تغییر مالی، یا write به هستهٔ دانش) به تأیید انسان و Audit Log نیاز دارد.

ساختار ریپو

casio-plus-mcp/
├── knowledge/
│   └── casio.yaml              # منبع فعلی مدل دانش کاسیو‌پلاس
├── src/
│   ├── server.ts               # MCP server با ابزارهای دانش/کیفیت/Review
│   ├── knowledge-store.ts      # Adapter برای YAML / Markdown / DB
│   ├── quality.ts              # Data Quality Gate
│   ├── intake-store.ts         # صف محلی بازخورد
│   ├── audit-store.ts          # ردپای ممیزی
│   └── proposal-store.ts       # پیشنهادهای نسخه‌ای
├── studio/                     # Prototype سبک Web/PWA responsive
│   ├── src/
│   └── public/casio.json
├── operator/                   # CasioPlus Command Core؛ مبتنی بر FounderOS (MIT)
│   ├── app/                    # Next.js Operator UI
│   ├── components/             # Shell، Graph، Palette، Agent/Workflow UI
│   ├── lib/casio-knowledge.ts  # Adapter مدل کاسیو
│   ├── knowledge/casio.yaml
│   └── NOTICE.md               # attribution مربوط به upstream
├── tests/
├── docs/
├── package.json
└── README.md

FounderOS: منبع الهام، نه قالب اجباری

FounderOS برای کاسیو‌پلاس یک reference implementation است، نه وابستگی معماری. از آن این الگوها را می‌آموزیم:

هیچ صفحه، دیتابیس، connector، نقش سازمانی یا جریان کاریِ FounderOS به‌صورت پیش‌فرض وارد کاسیو‌پلاس نمی‌شود. هر کدام فقط زمانی ساخته/اتصال داده می‌شود که یک نیاز واقعی کاسیو، مالک مشخص، خروجی قابل سنجش و مسیر بازگشت داده داشته باشد.

اگر در آینده یک داشبورد یا ابزار عملیاتی لازم باشد، می‌تواند یک UI بومی CasioPlus یا هر ابزار دیگری باشد. MCP به یک محصول رابط خاص قفل نمی‌شود.

نقشهٔ راه

Phase 0 — Foundation

• ایجاد مدل کاسیو.yaml

• استخراج مستندات کاسیو

• مدل HEGAM، معماری، آموزش و کیس‌استادی

• ایجاد اسکلت این ریپو و README

Phase 1 — Read-only MCP

• TypeScript + رسمی MCP SDK

• YAML Knowledge Store

• Resourceهای model, playbooks, architecture, learning

• Toolهای search_playbooks, get_playbook, get_architecture

• تست قراردادها و schema validation

Phase 2 — Quality & Feedback

• validate_record

• JSON-based local feedback intake queue (نسخهٔ سبک محلی)

• Data Quality Gate: completeness، reference، provenance، duplicate detection

• Audit log و review workflow نسخه‌ای

Phase 3 — Review، Audit و Version Proposal

• تأیید/رد بازخورد با شرط validated

• Audit Log محلی و immutable-style

• Version Proposal مستقل با base knowledge version

• ممنوعیت تغییر مستقیم casio.yaml

Phase 4 — CasioPlus Command Core

• واردکردن کامل FounderOS-DEMO تحت مجوز MIT و attribution حفظ‌شده

• Shell واقعی Next.js، Command Palette، Graph، Agent/Skill/Workflow stack و Test Stack

• جایگزینی صفحهٔ اصلی با CasioPlus Command Core بر پایهٔ ۵۶ پلی‌بوک و ۶ دامنهٔ واقعی

• Adapter بومی lib/casio-knowledge.ts برای مدل کاسیو

• تزریق اولیهٔ دادهٔ بومی کاسیو در Repository Layer: ۶ Department، ۸ Agent، نقش‌های انسانی، SOP، Domain، Metric و Roadmap

• تزریق Casio Metric: قرارداد داده، ذخیره‌ساز محلی، API GET/POST /api/casio-metric و route واقعی /analytics

• workflow کوچینگ در /tasks: قرارداد جلسه، گلوگاه، آمادگی، Action Plan، API GET/POST /api/coaching-sessions

• Funnel بومی در /funnel: مدل چهارمرحله‌ای کمپین و Campaign Sheet بر پایه پلی‌بوک‌های واقعی

• Content Engine بومی در /content: شش فرمت محتوا و دارایی‌های کانال بله

• RBAC Policy Layer: ۹ نقش HEGAM، permissionهای صریح و enforcement روی APIهای Metric و Coaching

• SSO Adapter: هویت امضاشدهٔ IdP/Reverse Proxy، timestamp validation و اتصال actor واقعی به RBAC

• پیکربندی IdP production (Keycloak / Authentik / Cloudflare Access)

• Agent Approval Gate و Automation Spec Registry: draft → pending_approval → approved/rejected → execution allowed

• Automation Runtime: اجرای policy-gated برای Spec تأییدشده و ثبت Automation Run Log

توسعهٔ محلی

MCP و HTTP Bridge

npm install
npm run check          # typecheck + tests
npm run start:stdio    # اجرای MCP با stdio برای MCP Clientها
npm run start:http     # اجرای Bridge محلی برای Studio روی پورت 4110

نصب امن Operator

cd operator
npm install
npm run setup:casio

Wizard فقط در ترمینال تعاملی اجرا می‌شود، credential نمی‌پرسد، network call ندارد و SSO را فعال نمی‌کند. جزئیات در operator/docs/safe-setup.md است.

CasioPlus Studio

cd studio
npm install
npm run dev            # Studio روی http://127.0.0.1:4173

در محیط توسعه، Vite درخواست‌های /api/* را به HTTP Bridge روی پورت 4110 proxy می‌کند. اگر Bridge در دسترس نباشد، Studio برای نمایش read-only به public/casio.json برمی‌گردد.

ابزارهای قابل استفاده در نسخهٔ فعلی

• search_playbooks

• get_playbook

• get_architecture

• get_learning_path

منابع MCP فعلی:

• casio://knowledge/summary

• casio://playbooks/{id}

منابع مفهومی

• HEGAM / Casio Plus: مدل دانش داخلی کاسیو‌پلاس در knowledge/casio.yaml

• FounderOS-DEMO: https://github.com/Bennettxai/FounderOS-DEMO

• Model Context Protocol: https://modelcontextprotocol.io/

• ISO 30401: سیستم مدیریت دانش

• Zettelkasten / SECI / ADDIE: مبانی دانش، یادگیری و دارایی‌سازی در مدل کاسیو

وضعیت

Repository status: Foundation + MCP Core + HTTP Bridge + CasioPlus Studio complete
Implementation status: MCP و HTTP Bridge از یک Core مشترک برای دانش، کیفیت و Review استفاده می‌کنند؛ Studio دادهٔ زنده را از Bridge می‌خواند و برای حالت آفلاین snapshot دارد.
Next step: قرارداد داده و داشبورد Casio Metric/کوچینگ.