درباره بیت پین

سرور MCP بیت‌پین (BitPin MCP Server)

این سرور با استفاده از پروتکل استاندارد Model Context Protocol (MCP)، دستیارهای هوش مصنوعی (نظیر Claude Desktop، Cursor، Antigravity، Cline و VS Code) را مستقیماً به API صرافی ارز دیجیتال بیت‌پین متصل می‌کند.

این ابزار چه کاری انجام می‌دهد؟

• دسترسی به بازار زنده: امکان مشاهده قیمت لحظه‌ای رمزارزها، تغییرات ۲۴ ساعته، دفتر سفارشات (Orderbook) و تاریخچه معاملات عمومی بدون نیاز به کلید API.
• مدیریت معاملات: ثبت و لغو انواع سفارش‌های خرید و فروش (Limit، Market، Stop-Limit و OCO) و مشاهده وضعیت سفارش‌های باز و انجام‌شده.
• مدیریت کیف پول: استعلام موجودی ارزها، تولید آدرس واریز بر روی شبکه‌های مختلف بلاک‌چین، مشاهده حساب‌های بانکی تومانی و تاریخچه واریز و برداشت.
• پشتیبانی دوطرفه از زبان فارسی: هوش مصنوعی توضیحات فنی را به زبان انگلیسی پردازش می‌کند، اما شما می‌توانید نام رمزارزها، اعداد و درخواست‌ها را کاملاً به زبان فارسی بنویسید.

نحوه راه‌اندازی و استفاده

این سرور در مخزن npm ثبت شده و بدون نیاز به دانلود دستی، مستقیماً از طریق npx اجرا می‌شود.

۱. پیکربندی در Claude Desktop

فایل تنظیمات claude_desktop_config.json را باز کرده و کد زیر را به بخش mcpServers اضافه کنید:

{
  "mcpServers": {
    "bitpin": {
      "command": "npx",
      "args": ["-y", "bitpin-mcp"],
      "env": {
        "BITPIN_API_KEY": "کلید_API_شما",
        "BITPIN_SECRET_KEY": "سکرت_کی_شما"
      }
    }
  }
}

نکته: برای استفاده از داده‌های عمومی بازار (مانند دریافت قیمت و اوردر بوک)، نیازی به وارد کردن بخش env و کلیدهای API نیست.

۲. پیکربندی در Cursor IDE

کد فوق را داخل فایل .cursor/mcp.json پروژه یا تنظیمات اصلی نرم‌افزار Cursor قرار دهید.

۳. نکته مهم امنیتی: محدودیت آی‌پی (خطای ۴۰۳)

کلیدهای API صرافی بیت‌پین تنها با آی‌پی‌های ثابت و ثبت‌شده در بخش مدیریت توکن (Token Manager) کار می‌کنند. در صورت فراخوانی ابزارهای معامله یا کیف‌پول از آی‌پی تایید‌نشده (مانند فیلترشکن یا اینترنت همراه با آی‌پی متغیر)، صرافی خطای HTTP 403 Forbidden برمی‌گرداند.