تثبيت وتهيئة خادم IronWallet MCP لـ Cursor وClaude Code وChatGPT وعملاء MCP الآخرين.
يمنح خادم IronWallet MCP (@ironwallet/mcp-server) وكلاء الذكاء الاصطناعي محفظة عملات مشفرة غير احتجازية على جهاز الكمبيوتر الخاص بك. يتم إنشاء عبارات الاسترداد وتشفيرها محلياً — فهي لا تغادر هذا الجهاز أبداً ولا تمر عبر الوكيل أو النموذج اللغوي الكبير (LLM) أو أنظمة IronWallet الخلفية. يمكن للوكلاء التحقق من الأرصدة، وعرض رموز QR للإيداع، وتحويل الرموز المميزة، والمبادلة عبر 12 شبكة: Ethereum وBSC وPolygon وBase وArbitrum وOptimism وAvalanche وTron وBitcoin وSolana وXRP وTON.
لا توجد واجهة مستخدم لتأكيد كل معاملة — بمجرد أن تطلب من الوكيل الإرسال أو المبادلة، يمكنه التوقيع والبث دون طلب ذلك مرة أخرى. استخدم محفظة ساخنة مخصصة ذات رصيد محدود، ولا تستخدم محفظتك الرئيسية أبداً.
المتطلبات: Node.js 20+ (npx). سطح المكتب / stdio فقط.
توقيع محلي غير احتجازي
تبقى عبارات الاسترداد مشفرة على المضيف (أذونات ملف المالك فقط). يتم توقيع المعاملات على هذا الجهاز؛ لا تقبل أي أداة عبارة استرداد ولا تعيدها.
محافظ في المتصفح المحلي
أنشئ محافظ باستخدام create_wallets (يعيد backup_url)، أو استورد وقم بالنسخ الاحتياطي من خلال open_wallet_manager — وهي صفحة محلية فقط على 127.0.0.1 تغلق بعد 15 دقيقة من عدم النشاط. تظهر الأسرار فقط في صفحة المتصفح تلك، ولا تظهر أبداً في الدردشة.
تحويلات مع تقديرات الرسوم
يقوم estimate_transfer بمعاينة الرسوم دون بث؛ يقوم send_transfer بالتوقيع محلياً والإرسال؛ يقوم get_operation_status باستطلاع النتيجة. قد يقلل الخادم المبلغ قليلاً حتى تتناسب الرسوم مع الرصيد — يوضح الرد متى حدث ذلك.
مبادلات قائمة على الكتالوج
يوفر list_swap_networks وlist_swap_assets كتالوج البيع/الشراء حتى لا يخترع الوكيل عناوين الرموز المميزة. يقوم estimate_swap بتقديم عرض سعر، وينفذ execute_swap على عرض سعر جديد، ويقوم get_swap_status بالاستطلاع.
رموز QR للإيداع
يعيد get_deposit_qr صورة PNG للدردشة بالإضافة إلى رابط qr_url محلي كبديل.
حدود إنفاق اختيارية
سياسة لكل محفظة عبر set_wallet_policy: readOnly، وmaxPerTxUsd، وقائمة سماح للمستلمين. متوقفة افتراضياً؛ تنطبق على كل من الإرسال والمبادلة. يجعل IW_READ_ONLY=true الخادم بأكمله للقراءة فقط.
الخيار 1: npx (موصى به)
استخدم npx لتشغيل الخادم دون تثبيت عالمي. يضمن هذا استخدامك دائماً لأحدث إصدار.
قد يستغرق التشغيل الأول حوالي 30 ثانية أثناء تثبيت التبعيات. إذا انتهت مهلة عميل MCP، قم بتشغيل الأمر مرة واحدة في الجهاز لتسخين ذاكرة التخزين المؤقت، ثم أعد الاتصال.
الخيار 2: التثبيت العالمي
قم بتثبيت الحزمة عالمياً لبدء تشغيل أسرع، ثم قم بتشغيل ironwallet-mcp.
لكل عميل رابط ثابت مخصص (على سبيل المثال /ai/introduction/vscode/). جميع أوامر التثبيت أدناه مضمنة أيضاً في هذه الصفحة — لا توجد علامات تبويب، ولا شيء مخفي خلف النقرات.
الأكثر توصية
يعمل بشكل جيد مع الإصدار المجاني، تثبيت سهل، أفضل تجربة
ثبته مرة واحدة. بعد ذلك، ستكون أدوات المحفظة متاحة في كل دردشة. يمكنك أيضاً لصق هذا في ~/.cursor/mcp.json وإعادة تشغيل Cursor.
أعد تحميل Cursor بعد التثبيت بحيث يتضمن PATH مسار npx.
صفحة مستقلة لـ Cursor — جلب HTTP واحد يعيد هذا الدليل فقط.
يتطلب مستوى خبير أعلى
يعمل بشكل جيد مع وضع الكود (Code mode)، وضع الدردشة محدود جداً
قم بتشغيل هذه الأوامر بالترتيب:
بعد تثبيت المكون الإضافي، انتظر حوالي 45 ثانية وابدأ دردشة جديدة حتى يتم تحميل الأدوات.
أو وجه Claude Code إلى خادم stdio مباشرة:
صفحة مستقلة لـ Claude Code — جلب HTTP واحد يعيد هذا الدليل فقط.
أعلى مستوى خبير
يتطلب مكونات إضافية إضافية مع الإصدار المدفوع من نماذج الذكاء الاصطناعي
يفتح VS Code ويسجل خادم MCP المحلي. يمكنك أيضاً إضافة هذا إلى إعدادات MCP في VS Code (للمستخدم أو مساحة العمل).
صفحة مستقلة لـ VS Code — جلب HTTP واحد يعيد هذا الدليل فقط.
إعداد سهل - يتطلب ChatGPT
الإصدار المجاني محدود جداً، الإصدار المدفوع يعمل بشكل أفضل
قم بتشغيل هذه الأوامر بالترتيب، ثم أعد التحميل لتصبح أدوات MCP متاحة.
أو وجه ChatGPT إلى خادم stdio مباشرة:
صفحة مستقلة لـ ChatGPT — جلب HTTP واحد يعيد هذا الدليل فقط.
استخدم نقل stdio. وجه عميل MCP الخاص بك إلى:
صفحة مستقلة لـ عملاء آخرون — جلب HTTP واحد يعيد هذا الدليل فقط.
لا يوجد تسجيل دخول ولا حساب. عند التشغيل الأول، يقوم الخادم بإنشاء أسراره المحلية — مفتاح API للترحيل، وسر تغليف مخزن المفاتيح، ومعرف الجهاز — تحت ~/.ironwallet-mcp/ مع أذونات المالك فقط. لا يوجد شيء للتهيئة.
لبدء استخدام محفظة:
Tronscanneraccept_mcp_consent)، أو تضغط على متابعة في مدير المحفظة.create_wallets يعيد أسماء المحافظ وعناوينها بالإضافة إلى backup_url — افتحه في متصفحك لعرض عبارة الاسترداد ونسخها احتياطياً. لاستيراد محفظة موجودة أو إجراء نسخ احتياطي لاحقاً، استخدم open_wallet_manager. يتم كتابة عبارة الاسترداد أو عرضها فقط في صفحة المتصفح المحلي، وليس في الدردشة أبداً.get_deposit_qr) أو عنواناً (list_wallets) وأرسل مبلغاً صغيراً. حافظ على محدودية الرصيد — هذه محفظة ساخنة.يحتفظ الخادم بحالته في ~/.ironwallet-mcp/ (يمكن تجاوزه باستخدام IW_KEYSTORE_DIR):
مخزن المفاتيح المشفر مع بذور محفظتك،
سر التغليف، ومفتاح API للترحيل، ومعرف الجهاز،
سجلات التشخيص تحت logs/ (لا يتم تسجيل مادة البذور أبداً).
تحذير: لا تحذف هذا المجلد لـ "إعادة تعيين" الخادم.
إنه يحتوي على المفاتيح المشفرة لأموالك. إذا قمت بإزالته دون إجراء نسخ احتياطي لعبارة الاسترداد في مدير المحفظة، فستضيع الأموال. نسختك الاحتياطية هي عبارة الاسترداد، وليس هذه الملفات.
أي شخص لديه مخزن المفاتيح و سر التغليف يتحكم في الأموال، لذا تعامل مع المجلد كبيانات حساسة.
معظم المستخدمين لا يحتاجون إلى تعيين أي متغيرات بيئة. يقوم الخادم بإنشاء وتخزين كل ما يحتاجه عند التشغيل الأول. فيما يلي المتغيرات المتاحة للاستخدام المتقدم:
send_transfer وexecute_swap على مستوى العملية. يختلف عن policy.readOnly لكل محفظة0 للتعطيل)debug / info / warn / errorلا تغادر البذور هذا الجهاز أبداً. يتم تشفيرها في حالة السكون ولا تظهر أبداً في نتائج الأدوات أو دردشة الوكيل أو السجلات أو طلبات النظام الخلفي. لا تقبل أي أداة بذرة ولا تعيدها — يتم الاستيراد والنسخ الاحتياطي فقط في المتصفح المحلي.
يمكن للوكيل نقل الأموال دون طلب ذلك مرة أخرى. لا توجد واجهة مستخدم لتأكيد كل معاملة؛ رسالة الدردشة الخاصة بك هي التفويض. التحويلات والمبادلات لا رجعة فيها بمجرد بثها.
حدود اختيارية. سياسة لكل محفظة (readOnly، وmaxPerTxUsd، وقائمة سماح للمستلمين) عبر set_wallet_policy، وIW_READ_ONLY=true على مستوى الخادم. كلاهما متوقف افتراضياً.
محفظة ساخنة فقط. لا تستورد محفظتك الرئيسية أو محفظة التوفير. أي شخص لديه مخزن المفاتيح وسر التغليف يتحكم في الأموال؛ لا يمكن إلغاء بذرة مسربة.
المهلة ليست فشلاً. استطلع get_operation_status / get_swap_status قبل إعادة محاولة الإرسال أو المبادلة.
تستخدم جميع طلبات النظام الخلفي HTTPS؛ تستخدم ملفات الأسرار المحلية أذونات المالك فقط (Unix 0600، وACL لـ NTFS على Windows).
الإفصاح عن الثغرات الأمنية: SECURITY.md.
اختبر الخادم مباشرة باستخدام مفتش MCP. يفتح هذا واجهة ويب تفاعلية حيث يمكنك اختبار استدعاءات الأدوات دون مساعد ذكاء اصطناعي.
npx يقوم بتنزيل الحزمة عند التشغيل الأول، وهو ما قد يستغرق حوالي 30 ثانية.
npx -y @ironwallet/mcp-server مرة واحدة في الجهاز لتسخين ذاكرة التخزين المؤقت، ثم أعد الاتصال.npm install -g @ironwallet/mcp-server@latest.node --version.PATH مسار npx.create_wallets يعيد needs_consentلم يتم قبول إخلاء مسؤولية MCP بعد. اطلب من الوكيل عرض إخلاء المسؤولية الكامل والتأكيد (accept_mcp_consent)، أو افتح مدير المحفظة واضغط على متابعة.
المهلة ليست فشلاً — قد تكون المعاملة قد تم بثها بالفعل. استطلع get_operation_status (للتحويلات) أو get_swap_status (للمبادلات) قبل إعادة المحاولة. لا تقم بإعادة الإرسال بشكل أعمى أبداً.
list_wallets → policy: قد يكون readOnly أو قائمة سماح للمستلمين تحظر العملية. { enabled: false } يعني عدم وجود حدود.maxPerTxUsd تفشل في حالة الإغلاق: إذا لم يكن سعر الدولار متاحاً للأصل، يتم رفض العملية.IW_READ_ONLY=true.