🎬 Hooshang AI MCP Server

سرور پروتکل کانتکست مدل برای هوش مصنوعی هوشنگ

Connect Claude Desktop, Cursor, and Antigravity to Iran's Premier Generative AI Engine for Filmmaking, Video Generation, and Music Scoring.

📖 راهنمای فارسی • 🇬🇧 English Guide • 🛠️ ابزارها • 🎥 مدل‌های پشتیبانی‌شده

🇮🇷 راهنمای فارسی

Hooshang AI MCP Server یک پل ارتباطی قدرتمند و استاندارد متن‌باز مبتنی بر پروتکل Model Context Protocol (MCP) است که هوش مصنوعی‌های پیشرو دنیا نظیر:

• Claude Desktop

• Cursor IDE

• Antigravity IDE

• Claude Code CLI

• Cline / Roo Code

را مستقیماً به زیرساخت هوش مصنوعی هوشنگ (Hooshang.ai) متصل می‌کند.

با این سرور، هوش مصنوعی شما تبدیل به یک دستیار کارگردان و تدوین‌گر ۲۴ ساعته می‌شود که می‌تواند بر اساس سناریوی شما ویدیوهای B-Roll سینمایی خلق کند، فریم‌های استوری‌بورد بسازد، موسیقی متن اختصاصی بسازد و فایل‌های خروجی را مستقیماً درون پروژه‌تان دانلود کند.

⚡ راه‌اندازی با ۱ کلیک (۱۰۰٪ خودکار و بدون کار دستی)

برای راه‌اندازی، کاربر نیازی به باز کردن هیچ فایلی، ویرایش کد JSON یا کپی کردن کوکی ندارد. فقط کافیست ترمینال سیستم خود (PowerShell، CMD یا Terminal مک) را باز کنید و دستور زیر را اجرا نمایید:

npx github:Hesvm/HooshangMCP setup

این دستور تک‌خطی چه کارهایی انجام می‌دهد؟

1. 🔍 استخراج خودکار سشن (Zero-Login): اگر در مرورگر سیستم‌تان قبلاً در سایت هوشنگ لاگین کرده باشید، سشن شما را در کمتر از ۱ ثانیه از دیتابیس لوکال مرورگر استخراج و اعتبارسنجی می‌کند. (اگر لاگین نبودید، یک پنجره سبک باز می‌شود تا شماره موبایل و کد پیامک را وارد کنید).

2. ⚡ تزریق خودکار تنظیمات MCP: نرم‌افزارهای Claude Desktop و Cursor و Antigravity را در سیستم شما شناسایی کرده و بدون دست زدن به سایر افزونه‌ها، کانفیگ هوشنگ را به فایل تنظیمات آن‌ها تزریق می‌کند.

3. تمام! فقط کافیست Claude یا Cursor را ببندید و دوباره باز کنید.

# بررسی وضعیت اعتبار، توکن و کاربر متصل
npx github:Hesvm/HooshangMCP status

🏛️ معماری سیستم و جریان کارکرد

flowchart LR
    subgraph Client["💻 دستیار هوش مصنوعی شما"]
        A["Claude Desktop / Cursor / Antigravity"]
    end

    subgraph MCP["⚡ Hooshang MCP Server"]
        B["Stdio Server Runner"]
        C["Smart Auth & Cookie Engine"]
        D["Asset Downloader"]
    end

    subgraph Cloud["☁️ Hooshang AI Cloud Engine"]
        E["🎬 Video Models\n(Veo 3.1, Kling, PixVerse)"]
        F["🖼️ Image Models\n(Kamal, Nano Banana)"]
        G["🎵 Music Agent\n(Cinematic Soundtrack)"]
    end

    A <-->|"JSON-RPC / MCP"| B
    B --> C
    C -->|"Authenticated API"| Cloud
    Cloud -->|"Render Stream"| B
    B --> D
    D -->|"Save MP4 / PNG"| A

🎨 نمونه خروجی تولید شده با MCP

تصویر زیر نمونه‌ای واقعی است که توسط دستیار هوش مصنوعی مستقیماً از طریق مدل لوکال کمال (Kamal) هوشنگ و به وسیله این MCP Server تولید شده است:

🎥 مدل‌های ویدیویی و تصویری پشتیبانی‌شده

🛠️ ابزارهای در دسترس (MCP Tools)

💻 کانفیگ دستی (در صورت عدم استفاده از setup خودکار)

اگر مایلید تنظیمات را دستی درون فایل‌های کانفیگ نرم‌افزارهای خود کپی کنید:

{
  "mcpServers": {
    "hooshang": {
      "command": "npx",
      "args": ["-y", "github:Hesvm/HooshangMCP"]
    }
  }
}

• Claude Desktop ویندوز: %APPDATA%\Claude\claude_desktop_config.json

• Claude Desktop مک: ~/Library/Application Support/Claude/claude_desktop_config.json

• Antigravity IDE: ~/.gemini/config/mcp_config.json

• Cursor IDE: ~/.cursor/mcp.json

Related MCP server: Photo AI Studio MCP Server

🇬🇧 English Documentation

Hooshang AI MCP Server exposes Iran's leading generative video, concept image, and music scoring capabilities directly to your LLM-driven environments (Claude Desktop, Cursor, Antigravity, Cline) through the standard Model Context Protocol (MCP).

⚡ Zero-Touch 1-Click Setup

No manual JSON editing or cookie extraction needed. Simply open your terminal and run:

npx github:Hesvm/HooshangMCP setup

This single command:

1. Auto-detects active Hooshang login from your local browser cookies in < 1 second. (Or launches a lightweight SMS/Google login window if not authenticated).

2. Auto-configures Claude Desktop, Cursor, and Antigravity without altering other servers.

3. Simply restart Claude Desktop / Cursor and enjoy!

🖥️ CLI Commands

🔒 Privacy & Security

• Local Storage: All authentication tokens are stored strictly on your local machine (~/.hooshang-mcp/session.json) with strict permission bits.

• Zero Telemetry: No user data or generated assets are sent to any third-party server besides Hooshang.ai API.

• Open Source: Full codebase is transparent and audited for community safety.

📄 License

Released under the permissive MIT License.
Created and maintained with ❤️ by Hesam Mousavi (Hesvm).
Contributions and Pull Requests are welcome!