Install
{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}لمن هذا مناسب
- المطورون الذين يحتاجون إلى حسابات أعداد صحيحة عالية الدقة: مبني على BigInt الأصلي، مع صفر فقدان للدقة في الأعداد الصحيحة 64 بت و128 بت وأكثر، ويدعم تمثيل المتمم الثنائي (two's complement) بالإشارة وبدونها بأعرض 8/16/32/64 بت.
- من يعملون في تصحيح الأخطاء منخفضة المستوى أو الهندسة العكسية أو تحليل البروتوكولات: عند الحاجة إلى العمليات الثنائية على البت (bitwise)، أو تبديل ترتيب البايتات (endianness)، أو تفكيك تنسيق الفاصلة العائمة IEEE 754، يمكن إنجاز ذلك كلها في خادم MCP واحد.
- من يحتاجون إلى سلسلة خطوات حسابية متعددة في تنفيذ واحد: محرك التنفيذ الدفعي المتسلسل batch_calc يتيح الإشارة إلى نتيجة الخطوة السابقة باستخدام
{"$step": index, "field": "..."}، مما يغني عن النسخ اليدوي للقيم الوسيطة. - الحالات غير المناسبة: هذه ليست أداة محادثة أو بحث عامة؛ تعمل على Node.js وتتطلب من العميل دعم إعداد MCP بوضع stdio. لم يذكر ملف README إمكانية استخدامه في المتصفح أو البيئات الخالية من Node، وهذا غير مؤكد.
أول تجربة في 3 دقائق
المتطلبات المسبقة: أن يكون Node.js مثبتًا على جهازك، وأن يدعم عميل MCP لديك إعداد mcpServers (يقدم README تنسيق هذا الإعداد).
المسار الرئيسي الموصى به (موسوم في README بـ Option A, Recommended): أضف إلى إعدادات العميل:
{"mcpServers":{"calculate-mcp":{"command":"npx","args":["-y","calculate-mcp"]}}}
بعد الحفظ، أعد تشغيل العميل أو حدّثه، وسيقوم العميل تلقائيًا بسحب الخادم وتشغيله عبر npx (وضع stdio) دون تثبيت يدوي.
يُنصح في الاستدعاء الأول باختيار قدرة حسابية خالصة ذات طبيعة للقراءة فقط، مثل إجراء تحويل عدد صحيح بدقة عشوائية عبر int_convert، أو تفكيك عدد عائم باستخدام ieee754_convert — فهذه عمليات حسابية رقمية محلية لا تتضمن كتابة ملفات أو إرسال بيانات إلى جهة بعيدة.
إشارة النجاح: ظهور الأدوات التي يوفرها calculate-mcp في قائمة أدوات العميل (يصف README إجمالي 29 أداة متخصصة)، وعودة النتائج الصحيحة لطلبات الحساب. إذا كانت قائمة الأدوات فارغة، فتحقق من مطابقة تنسيق إعدادات العميل للنموذج أعلاه.
طريقة ثانوية (للإرشاد، وليست المسار الرئيسي): يذكر README إمكانية تشغيله محليًا بوضع stdio (npm start، مع الحاجة أولًا إلى بناء TypeScript إلى build/)، وهو مناسب لمن يرغب في تعديل الشيفرة المصدرية أو التشغيل دون اتصال.
ملاحظة: الأمر npx -y يسحب الحزمة من npm ويشغلها، وسيتم التنزيل عبر الإنترنت عند أول تشغيل؛ هذه هي الطريقة الموصى بها صراحة في README الرسمي.
حالات الاستخدام
الحالة الأولى: التحقق من التمثيل على مستوى البت لعدد صحيح 128 بت. السيناريو: أنت تتحقق من عدد صحيح يتجاوز 64 بت في أحد حقول بروتوكول. استخدم int_convert لإجراء تحويل عدد صحيح بدقة عشوائية، وأدخل العدد الكبير وحدد الأساس/العرض المطلوبين؛ ولأن الأساس يستخدم BigInt الأصلي، فلا يوجد أي فقدان للدقة في الأعداد 64 بت و128 بت وأكثر، مع دعم تمثيل المتمم الثنائي بالإشارة وبدونها بأعرض 8/16/32/64 بت، يمكنك مباشرة مقارنة مخرجات المتمم الثنائي بما تتوقعه.
الحالة الثانية: تحليل ثنائي متعدد الخطوات في استدعاء واحد. السيناريو: تحتاج إلى تطبيق عملية bitwise على نفس العدد، ثم تبديل ترتيب البايتات، ثم تفكيك IEEE 754. استخدم batch_calc للتنفيذ الدفعي المتسلسل: اكتب الخطوات في استدعاء دفعي واحد، وأشر الخطوات اللاحقة إلى نتيجة الخطوة السابقة باستخدام {"$step": index, "field": "..."}. النتيجة المتوقعة: يعيد الاستدعاء الواحد جميع النتائج الوسيطة والنهائية؛ أما أسماء معاملات كل خطوة فاعتمد على تلميحات schema للأداة في عميلك، إذ لم يسرّد README تفاصيل معاملات كل أداة على حدة، ويجب تأكيد هذا الجزء أثناء التشغيل.
حدود الاستخدام
- طبيعة القراءة/الكتابة: جميع الأدوات المذكورة تؤدي حسابات رقمية/ترميز محلية؛ لم يذكر README وجود كتابة ملفات أو إرسال بيانات عبر الشبكة أو عمليات على الحسابات، ولم يقدم أي إطار للتراجع (undo)، فلا يمكن الادعاء بأي «قابلية للتراجع».
- بيانات الاعتماد: لا يوجد؛ لا تحتوي الإعدادات على مفاتيح أو رموز (tokens).
- متطلبات التشغيل: بيئة Node.js؛ التنفيذ مبني على TypeScript خالص + مكتبة Node.js القياسية + Zod، دون تبعيات أصلية ثقيلة.
- القيود الرسمية الصريحة: لم يقدم README أي بيانات حول حدود المعدل أو نطاق الأذونات أو خصوصية البيانات — هذه معلومات أساسية غير مؤكدة، ولا ينبغي افتراض أي حدود للخصوصية عند الاستخدام.
- غير مؤكد بعد: القائمة الكاملة لمعاملات كل أداة، والتوافق مع أنظمة التشغيل، ورقم الإصدار المحدد لحزمة npx.