← بازگشت به Marketplace

ابزارهای عمومی ایران

Iran Utility MCP

ابزارهای فارسی رایگان فعال برای تست رایگان
راهنمای استفاده مستندات تست سرویس

تبدیل تاریخ جلالی/میلادی، زمان ایران و مناسبت‌ها.

تبدیل تاریخ جلالی/میلادی، زمان ایران و مناسبت‌ها.

📘 راهنمای استفاده از این سرویس MCP

MCP چیست و این صفحه چه می‌کند؟

Model Context Protocol (MCP) یک استاندارد برای وصل کردن ابزارها (Tools) به ایجنت‌های هوش مصنوعی و اتوماسیون است. هر سرویس در Marketplace مجموعه‌ای از Tool دارد؛ هر Tool یک ورودی مشخص (JSON Schema) و یک خروجی ساخت‌یافته برمی‌گرداند. در دهکده می‌توانید Tool را همین‌جا تست کنید، از مستندات بخوانید، و بعداً به Workflow یا کلاینت MCP وصل کنید.

مراحل سریع (همین صفحه)

  1. وضعیت سرویس را ببینید: فعال برای تست یعنی Provider واقعی ثبت شده است.
  2. در بخش ابزارها نام Tool، توضیح و Schema ورودی/خروجی را بخوانید.
  3. به بخش تست سرویس بروید، Tool را انتخاب کنید و فیلدها را پر کنید.
  4. روی «اجرای تست» بزنید؛ پاسخ JSON در همان صفحه نشان داده می‌شود.
  5. در صورت خطا، کد خطا (NOT_FOUND، SERVICE_UNAVAILABLE، INTERNAL_ERROR) را در پیام ببینید.

فراخوانی از طریق API (برای توسعه‌دهنده)

Tester داخلی از همین endpoint استفاده می‌کند:

POST /Mcp/ExecuteTool
Content-Type: application/json

{
  "slug": "iran-utility",
  "tool": "نام_ابزار",
  "arguments": { }
}

مقدار tool باید دقیقاً همان Name ابزار باشد (نه فقط عنوان نمایشی). فیلد arguments مطابق Input Schema همان Tool پر می‌شود.

اتصال در Workflow دهکده

  1. از داشبورد یک گردش‌کار بسازید یا قالب آماده را Import کنید.
  2. نود HTTP Request (یا نود MCP در صورت فعال بودن در ادیتور) را اضافه کنید.
  3. آدرس /Mcp/ExecuteTool را با بدنه JSON بالا صدا بزنید.
  4. خروجی را به نود بعدی (شرط، تلگرام، ذخیره دیتابیس و …) وصل کنید.

Endpoint و کلاینت MCP خارجی

اجرای تست از داخل سایت فعال است. Endpoint استاندارد MCP و صدور API Key از پنل کاربری در نسخه‌های بعدی اضافه می‌شود. تا آن زمان از Tester یا POST /Mcp/ExecuteTool استفاده کنید.

نکات مهم

  • سرویس‌های رایگان و Active (مثل Iran Utility و Developer Tools) بدون Credential اضافه قابل تست‌اند.
  • برای SMS، پرداخت و جست‌وجو تا زمان اتصال Provider واقعی، وضعیت Development است و نباید به‌عنوان API نهایی در تولید استفاده شوند.
  • اگر خطای مربوط به SQL یا INTERNAL_ERROR دیدید، اتصال دیتابیس سرور را بررسی کنید؛ خود Tool ممکن است سالم باشد.
  • مستندات تفصیلی هر سرویس: صفحه مستندات.

ابزارها (Tools)

jalali_to_gregorian
جلالی به میلادی

تبدیل تاریخ جلالی

Input Schema
{"type":"object","properties":{"date":{"type":"string","description":"مثلاً 1403/01/01"}},"required":["date"]}
Output Schema
{"type":"object"}
gregorian_to_jalali
میلادی به جلالی

تبدیل تاریخ میلادی

Input Schema
{"type":"object","properties":{"date":{"type":"string","description":"yyyy-MM-dd"}},"required":["date"]}
Output Schema
{"type":"object"}
get_today
امروز

تاریخ امروز

Input Schema
{"type":"object","properties":{}}
Output Schema
{"type":"object"}
get_iran_time
زمان ایران

زمان فعلی ایران

Input Schema
{"type":"object","properties":{}}
Output Schema
{"type":"object"}
is_holiday
آیا تعطیل است

بررسی تعطیلی

Input Schema
{"type":"object","properties":{"date":{"type":"string","description":"تاریخ"}},"required":[]}
Output Schema
{"type":"object"}
get_holidays
لیست تعطیلات

تعطیلات سال

Input Schema
{"type":"object","properties":{"year":{"type":"integer","description":"سال جلالی"}},"required":[]}
Output Schema
{"type":"object"}
get_occasion
مناسبت

مناسبت روز

Input Schema
{"type":"object","properties":{"date":{"type":"string","description":"تاریخ"}},"required":[]}
Output Schema
{"type":"object"}
validate_mobile
اعتبارسنجی موبایل

اعتبارسنجی موبایل

Input Schema
{"type":"object","properties":{"mobile":{"type":"string","description":"09…"}},"required":["mobile"]}
Output Schema
{"type":"object"}
normalize_mobile
نرمال‌سازی موبایل

نرمال‌سازی موبایل

Input Schema
{"type":"object","properties":{"mobile":{"type":"string","description":"شماره"}},"required":["mobile"]}
Output Schema
{"type":"object"}
validate_national_id
اعتبارسنجی کد ملی

اعتبارسنجی کد ملی

Input Schema
{"type":"object","properties":{"nationalId":{"type":"string","description":"کد ملی"}},"required":["nationalId"]}
Output Schema
{"type":"object"}
validate_sheba
اعتبارسنجی شبا

اعتبارسنجی شبا

Input Schema
{"type":"object","properties":{"sheba":{"type":"string","description":"IR…"}},"required":["sheba"]}
Output Schema
{"type":"object"}
amount_to_words_fa
مبلغ به حروف

مبلغ به حروف

Input Schema
{"type":"object","properties":{"amount":{"type":"integer","description":"ریال"}},"required":["amount"]}
Output Schema
{"type":"object"}
is_weekend
آیا آخر هفته

آیا آخر هفته

Input Schema
{"type":"object","properties":{"date":{"type":"string","description":"yyyy-MM-dd"}},"required":[]}
Output Schema
{"type":"object"}
add_working_days
جمع روز کاری

جمع روز کاری

Input Schema
{"type":"object","properties":{"date":{"type":"string","description":"تاریخ"},"days":{"type":"integer","description":"تعداد"}},"required":["days"]}
Output Schema
{"type":"object"}

نحوه اتصال

اجرای تست از داخل سایت فعال است. Endpoint عمومی MCP و صدور API Key در نسخه‌های بعدی از پنل کاربری ارائه می‌شود.

Placeholder: /mcp/iran-utility

تست سرویس


    

  









  

  
نظرات کاربران

    
هنوز نظر تأییدشده‌ای ثبت نشده است. اولین نفر باشید.


  

    
ثبت نظر

    
پس از بررسی مدیر نمایش داده می‌شود.