Skip to main content
Glama

MCP پوشفا

MCP رسمی پوشفا برای خواندن راهنمای نصب وب، اندروید و iOS و کار با وب‌سرویس‌های یک سرویس پوشفا. روی سیستم شما با stdio اجرا می‌شود و برای دریافت راهنما و عملیات سرویس به pushfa.com متصل می‌شود.

بسته در npm · صفحهٔ نصب و دانلود · مستندات فنی MCP

نصب

به Node.js نسخهٔ ۲۲ یا بالاتر و کلاینتی با پشتیبانی از MCP محلی نیاز دارید. برای اجرا از npm، این تنظیم را در کلاینت‌های دارای قالب mcpServers وارد کنید.

{
  "mcpServers": {
    "pushfa": {
      "command": "npx",
      "args": ["-y", "pushfa-mcp"]
    }
  }
}

برای اجرا از GitHub، مقدار فیلد args را با آرایهٔ زیر جایگزین کنید.

[
  "--yes",
  "--package=git+https://github.com/ehsan-coder/pushfa-mcp.git",
  "pushfa-mcp"
]

برای نصب دستی، فایل یکپارچه را بگیرید و در تنظیمات کلاینت، فرمان node و مسیر کامل فایل را وارد کنید. اگر مخزن را کلون یا ZIP آن را استخراج کرده‌اید، node src/index.mjs نیز از ریشهٔ پروژه اجرا می‌شود. اجرای کد به نصب وابستگی نیاز ندارد.

Related MCP server: OneSignal MCP Server

کلیدها و دسترسی‌ها

برای خواندن راهنماها هیچ کلیدی لازم نیست. برای کار با سرویس، متغیرها را در بخش env تنظیمات محلی اتصال وارد کنید و اتصال را دوباره راه‌اندازی کنید.

متغیر

کاربرد

PUSHFA_API_PUBLIC_KEY

کلید عمومی سرویس

PUSHFA_API_PRIVATE_KEY

کلید خصوصی همان سرویس

PUSHFA_MCP_ENABLE_SEND

مقدار رشته‌ای true برای فعال‌کردن ارسال

PUSHFA_MCP_ENABLE_MANAGEMENT

مقدار رشته‌ای true برای عملیات مدیریتی

با هر دو کلید، ابزارهای استعلامِ وضعیت اعلان و اشتراک، Alias، براکت‌ها و اطلاعات تاپیک فعال می‌شوند. ابزارهای ارسال به شناسهٔ مخاطب، توکن FCM، Alias، Custom Alias و تاپیک، بسته به نوع اعلان و وب‌سرویس درخواستی، دسترسی ارسال را می‌خواهند. ابزارهای مدیریتی شامل تغییر Alias و براکت، عضویت تاپیک، کاربر آزمایشی و ثبت پروفایل و رویداد RetenX هستند.

دستیار ابتدا یک پیش‌نمایش با pushfa_prepare_* می‌گیرد. پس از تأیید شما، pushfa_send_notification ارسال را ثبت می‌کند و pushfa_confirm_management پیش‌نمایش مدیریتی را اجرا می‌کند. شناسهٔ پیش‌نمایش پنج دقیقه در همان پردازش معتبر است و فقط یک بار می‌توان برای اجرای عملیات از آن استفاده کرد. کلید خصوصی را در تنظیمات محلی نگه دارید. امکانات سرویس و هزینه‌ها طبق پلن و تعرفهٔ پوشفا محاسبه می‌شوند.

نمونه درخواست

  • «راهنمای Web Push پوشفا را بخوان و مراحل لازم برای نصب در این پروژه را انجام بده.»

  • «وضعیت اعلان با شناسهٔ [شناسه] را بررسی کن و زمان تحویل یا کد خطا را بگو.»

  • «برای کاربر با Alias [شناسه] اعلان آماده کن و پیش از ارسال پیش‌نمایش را نشان بده.»

ساختار کد

مسیر

مسئولیت

src/index.mjs

ورودی برنامه و پروتکل MCP روی stdin و stdout

src/tools.mjs و src/schemas.mjs

تعریف ابزارها و اعتبارسنجی ورودی

src/client.mjs و src/config.mjs

اتصال به API پوشفا و تنظیم دسترسی ابزارها

src/guides.mjs و src/drafts.mjs

خواندن راهنماها و مدیریت پیش‌نمایش‌های یک‌بارمصرف

pushfa-mcp.mjs

خروجی یکپارچه برای دانلود و اجرای مستقیم

بعد از تغییر کد در src/، با npm ci و سپس npm run build فایل یکپارچه را دوباره تولید کنید.

مجوز

کد این مخزن با مجوز MIT منتشر می‌شود.

Available Tools

1 tool
pushfa_read_installation_guideA
Read-only

Read the current official Markdown guide before installing or upgrading Pushfa in a Web Push, native Android, or native iOS project. The first page includes section offsets; continue with next_offset or jump to a section using the returned revision.

Inputs: platform (required), offset, revision.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusing it with another. Its purpose—reading the installation guide—is stated explicitly and unambiguously.

    Naming Consistency4/5

    The single name follows a clear snake_case verb_noun pattern (pushfa_read_installation_guide) with a namespaced prefix. With only one tool there is no opportunity to demonstrate consistency across a set, so it cannot earn a full 5.

    Tool Count2/5

    A single read-only documentation tool is a very thin surface for a server named Pushfa MCP, which suggests broader installation/configuration functionality. Only one tool feels under-scoped for the apparent domain.

    Completeness2/5

    The surface covers only reading a guide; there is no way to check versions, validate configuration, or apply/perform installation steps. Even within a documentation scope, no search or section-listing tool accompanies the offset-based paging.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Amazon services through AI assistants, allowing users to search products, manage their cart, view order history, and place orders using natural language.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage OneSignal push notifications, email, SMS, and user management through natural language. Supports multi-channel messaging, segmentation, templates, analytics, and iOS Live Activities with 50+ tools for complete OneSignal API coverage.
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables sending web push notifications and managing Pushpad resources (notifications, subscriptions, projects, and senders) through natural language, using the Pushpad API.
      19
      1
      MIT