شروع
استفاده با هوش مصنوعی
سرور MCP کاشی دستیارهای هوش مصنوعی را مستقیم به مستندات، آیکونها، توکنها و ابزارهای فارسی کاشی وصل میکند.
دستیار هوش مصنوعیتان، کاشی را از نزدیک میشناسد.
Claude، Cursor و Copilot دیگر prop های کاشی را حدس نمیزنند. @kashi-ui/mcp مستندات هر کامپوننت، ۴٬۵۰۰ آیکون، توکنها و ابزارهای فارسی را در اختیارشان میگذارد تا کدی بنویسند که همان بار اول اجرا شود.
claude mcp add kashi -- npx -y @kashi-ui/mcp- Claude Code
- Cursor
- VS Code
- Windsurf
- Claude Desktop
- Zed
- ابزار برای دستیار
- ۸
- صفحهٔ مستندات
- ۷۱
- آیکون قابل جستجو
- ۴٬۵۰۰
- کلید API و سرور
- ۰
چرا MCP
کاشی جدید است و مدلهای زبانی تقریباً چیزی دربارهٔ آن نمیدانند؛ بیاطلاع، prop هایی میسازند که وجود ندارند. با MCP، دستیار پیش از نوشتن از خود کاشی میپرسد.
<DatePicker calendar="jalali" format="jYYYY/jMM/jDD" onDateSelect={setDate} />
سه prop ساختگی؛ کد اجرا نمیشود یا بیصدا کار نمیکند.
<DatePicker label="تاریخ تولد" max={new Date()} onChange={setDate} />
همان prop هایی که در جدول ویژگیهای کامپوننت آمده؛ شمسی بهطور پیشفرض.
نصب در سه قدم
سرور را به دستیارتان اضافه کنید
در ترمینال، داخل پوشهٔ پروژه:
claude mcp add kashi -- npx -y @kashi-ui/mcpفایل .cursor/mcp.json در ریشهٔ پروژه:
{ "mcpServers": { "kashi": { "command": "npx", "args": [ "-y", "@kashi-ui/mcp" ] } } }فایل .vscode/mcp.json برای GitHub Copilot:
{ "servers": { "kashi": { "command": "npx", "args": [ "-y", "@kashi-ui/mcp" ] } } }Settings › Developer › Edit Config، فایل claude_desktop_config.json:
{ "mcpServers": { "kashi": { "command": "npx", "args": [ "-y", "@kashi-ui/mcp" ] } } }فایل ~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "kashi": { "command": "npx", "args": [ "-y", "@kashi-ui/mcp" ] } } }دستیار را دوباره باز کنید
ابزارهای kashi در فهرست ابزارها دیده میشوند؛ در Claude Code با دستور
/mcpوضعیتش را ببینید.به زبان خودتان بخواهید
مثلاً: «با کاشی یک فرم ورود با موبایل و کد تأیید بساز.» دستیار خودش مستندات را میخواند.
ابزارها
دستیار خودش تصمیم میگیرد کدام ابزار را صدا بزند؛ لازم نیست اسمشان را بدانید.
kashi_get_docsمستندات کامل یک کامپوننتprop ها، نمونهٔ React و HTML، متغیرهای CSS و دسترسپذیریkashi_search_docsجستجو در مستنداتفارسی یا انگلیسی: «شبا»، «modal»، «جدول»kashi_list_docsفهرست همهٔ صفحههاکامپوننتها، فیلدهای فارسی و راهنماها
kashi_search_iconsجستجوی آیکونبین ۴٬۵۰۰ آیکون با نام فارسی یا انگلیسیkashi_get_iconکد آیکونکامپوننت React یا SVG در هر شش سبکkashi_get_tokensتوکنهای طراحیرنگ، فاصله، سایه و متغیرهای تمkashi_create_themeساخت تم برندیک رنگ بدهید، CSS کامل تم بگیرید
kashi_persianاعتبارسنجی و تبدیلکد ملی، شبا و کارت با نام بانک، موبایل با اپراتور، تاریخ شمسی، عدد به حروف
همهٔ صفحههای مستندات به شکل resource هم در دسترساند (kashi://docs/…) تا در دستیارهایی که این امکان را دارند، به گفتگو ضمیمه شوند.
چه بپرسیم
یکی را کپی کنید و در دستیارتان امتحان کنید.
- یک فرم ثبتنام با کد ملی، موبایل و تاریخ تولد شمسی با کاشی بساز.
- صفحهٔ پرداخت با شماره کارت، شبا و مبلغ به حروف درست کن.
- داشبورد فروش با کارت آمار، جدول سفارشها و نمودار ماهانه.
- تم برند ما با رنگ #3d5ef8 و گوشههای گردتر را بساز.
- برای دکمهٔ «افزودن به سبد» یک آیکون مناسب پیدا کن.
- این کد ملی و شبا معتبرند؟ دادههای تستی درست هم بساز.
llms.txt
برای دستیارهایی که MCP ندارند، همین مستندات به شکل متن ساده و طبق استاندارد llms.txt (در پنجرهٔ جدید) روی سایت هست:
/llms.txtفهرست همهٔ صفحهها با یک خط توضیح/llms-full.txtکل مستندات در یک فایل، برای ضمیمه کردن به گفتگوپرسشهای رایج
کلید API یا حساب کاربری لازم دارد؟
نه. سرور روی کامپیوتر خودتان با npx اجرا میشود و همهٔ مستندات داخل خود پکیج است. چیزی به جایی فرستاده نمیشود و بعد از نصب بدون اینترنت هم کار میکند.
مستندات سرور با سایت فرق دارد؟
نه. متن سرور از همین صفحههای سایت ساخته میشود و با هر نسخهٔ کاشی منتشر میشود. دستور npx -y همیشه آخرین نسخه را اجرا میکند.
کدام دستیارها پشتیبانی میشوند؟
هر ابزاری که MCP را پشتیبانی کند: Claude Code، Claude Desktop، Cursor، VS Code با Copilot، Windsurf، Zed و بقیه. تنظیمات همه یک دستور است: npx -y @kashi-ui/mcp.
دستیار من MCP ندارد؛ چه کنم؟
از llms.txt استفاده کنید. نشانی kashi.sepantapouya.com/llms-full.txt کل مستندات را در یک فایل متنی دارد که میشود به گفتگو داد یا دستیار خودش بخواند.