CalculatorLib MCP

التثبيت في 60 ثانية

اختر العميل الذي تستخدمه، الصق المقتطف، أعد التشغيل. هذا كل شيء.

Claude Code Claude Desktop Cursor Zed Cline Windsurf أخرى / عام

claude mcp add --transport http calculatorlib https://calculatorlib.com/mcp

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "context_servers": {
    "calculatorlib": {
      "source": "custom",
      "transport": {
        "type": "streamable-http",
        "url": "https://calculatorlib.com/mcp"
      }
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "transportType": "streamableHttp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "serverUrl": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "transport": "streamable-http",
  "endpoint": "https://calculatorlib.com/mcp"
}

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

جرّب هذه المطالبات

بعد التثبيت، تحدّث إلى Claude بلغة طبيعية فحسب — وسيختار الأداة المناسبة.

ساحة تجربة مباشرة

استدعِ الخادم من هنا مباشرة — JSON-RPC حقيقي إلى https://calculatorlib.com/mcp واستجابات حقيقية. بدون تسجيل. جارٍ تحميل الأدوات…

متصفّح الأدوات

ابحث في مكتبة الحاسبات و9 فئة من المحوّلات بالاسم أو العنوان. مفيد عند اكتشاف ما تطلبه من Claude.

كيف يعمل

• نقطة النهاية: معالج POST وحيد عند https://calculatorlib.com/mcp يتحدّث JSON-RPC 2.0 عبر Streamable HTTP (مواصفات النقل 2025-06-18).
• تسمية الأدوات: تستخدم معرّفات الحاسبات صيغة snake_case (bmi_calculator، compound_interest_calculator)؛ والمحوّلات على هيئة convert_<category>.
• المدخلات: تنشر كل أداة مخطط JSON Schema مُشتقًّا من حقول نموذج الحاسبة (النوع، التعداد، الحد الأدنى/الأقصى). تُدرَج الحقول الشرطية (مثل المتري مقابل الإمبراطوري في مؤشر كتلة الجسم) كحقول اختيارية — اقرأ وصف كل حقل لمعرفة التركيبات الصالحة.
• المخرجات: ملخص نصي من سطر واحد بالإضافة إلى كائن JSON باسم structuredContent يمكن للنموذج اللغوي تحليله (مثل { "main": [{...}], "data": [...] }).
• التحديثات: يُحدَّث الكتالوج كل 5 دقائق — تظهر الحاسبات المنشورة حديثًا تلقائيًا.

واجهة API مباشرة (لا حاجة لعميل MCP)

أتريد التكامل دون عميل MCP؟ البيانات نفسها متاحة عبر نقاط نهاية JSON بسيطة.

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"bmi_calculator",
      "arguments":{"unitSystem":"metric","weight":70,"height":170}
    }
  }'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":3,"method":"tools/call",
    "params":{
      "name":"convert_length",
      "arguments":{"value":5,"from":"Meter","to":"Foot"}
    }
  }'

نقاط نهاية REST (دون غلاف JSON-RPC):

• /api/calculators/schemas?q=<keywords> — البحث عن الحاسبات (مطابقات محدودة مع مخططات المدخلات)
• /api/converter/categories — فئات المحوّلات مع الوحدات
• POST /api/converter/convert — محوّل مباشر، الجسم { category, from, to, value }

المصادقة (اختيارية لكنها موصى بها)

الاستدعاءات المجهولة تعمل — المصادقة اختيارية. إضافة رمز يفتح تحليلات الاستخدام لكل مستخدم في /account/mcp-logs: يظهر هناك كل استدعاء تجريه عبر رمز، مع زمن الاستجابة وسبب الخطأ والحاسبة التي استدعيتها.

احصل على رمز (60 ثانية)

1. سجّل الدخول (أو أنشئ حسابًا أولًا).
2. انتقل إلى /account/api-tokens.
3. انقر Generate token. انسخ القيمة — تُعرض مرة واحدة فقط.

أضفه إلى عميل MCP لديك

نفس ملف الإعدادات المستخدم في التثبيت العام، بالإضافة إلى حقل headers.Authorization:

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

لماذا تتكبّد العناء؟

• سجلات استخدام شخصية — اطّلع على الحاسبات التي تستدعيها أكثر وأيّها يفشل، ضمن نطاق رمزك فقط (/account/mcp-logs).
• عملاء متعددون، رموز منفصلة — أنشئ رمزًا لكل جهاز (حاسوب محمول، خادم، وكيل). إبطال أحدها لا يعطّل البقية.
• أساس لميزات مستقبلية لكل مستخدم — عند إضافة حدود المعدّل / الحصص / الإعدادات المحفوظة، ستُربط بالاستدعاءات المُصادَق عليها.

curl مع رمز Bearer

curl -X POST https://calculatorlib.com/mcp \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

لمشغّلي الخوادم: اضبط MCP_REQUIRE_AUTH=true لطلب رمز في كل استدعاء (المجهول → 401). لا يزال متغيّر البيئة القديم MCP_API_TOKEN يعمل كتجاوز بسرّ مشترك واحد.

الأسئلة الشائعة & استكشاف الأخطاء