CalculatorLib MCP
हज़ारों कैलकुलेटर और 67 यूनिट-कन्वर्टर श्रेणियों को — केवल 70 सघन टूल के रूप में समेटकर (पहले कैलकुलेटर खोजें, फिर उसे चलाएँ) — किसी भी Model Context Protocol क्लाइंट से जोड़ें। Claude से “70 kg वज़न और 170 cm कद पर मेरा BMI क्या है?” या “5 मीटर को फ़ीट में बदलो” जैसे सवाल पूछें और मनगढ़ंत गणित के बजाय एक भरोसेमंद उत्तर पाएँ।
60 सेकंड में इंस्टॉल करें
अपना क्लाइंट चुनें, स्निपेट पेस्ट करें, फिर से शुरू करें। बस इतना ही।
बस एक कमांड चलाएँ और Claude Code कनेक्शन सेट कर देता है:
claude mcp add --transport http calculatorlib https://calculatorlib.com/mcp
या, यदि आप कॉन्फ़िग फ़ाइल ~/.claude/mcp.json को स्वयं संपादित करना चाहें:
{
"mcpServers": {
"calculatorlib": {
"url": "https://calculatorlib.com/mcp"
}
}
}
Claude Code के अंदर /mcp से सत्यापित करें — आपको calculatorlib कनेक्टेड और 70 टूल सूचीबद्ध दिखने चाहिए।
अपना Claude Desktop कॉन्फ़िग संपादित करें:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
नीचे दी गई mcpServers प्रविष्टि जोड़ें (जो पहले से है उसके साथ मर्ज करें):
{
"mcpServers": {
"calculatorlib": {
"url": "https://calculatorlib.com/mcp"
}
}
}
Claude Desktop को फिर से शुरू करें। इनपुट बॉक्स में हथौड़ा आइकन calculatorlib को 70 टूल के साथ दिखाएगा।
Cursor सेटिंग्स खोलें → MCP → Add new MCP server, फिर पेस्ट करें:
{
"mcpServers": {
"calculatorlib": {
"url": "https://calculatorlib.com/mcp"
}
}
}
Cursor वही Streamable HTTP ट्रांसपोर्ट उपयोग करता है, इसलिए JSON स्कीमा Claude Desktop जैसा ही है।
अपनी Zed सेटिंग्स संपादित करें (cmd+, / ctrl+, → Open Settings) और context_servers के अंतर्गत कैलकुलेटर सर्वर जोड़ें:
{
"context_servers": {
"calculatorlib": {
"source": "custom",
"transport": {
"type": "streamable-http",
"url": "https://calculatorlib.com/mcp"
}
}
}
}
असिस्टेंट पैनल को फिर से लोड करें; कैलकुलेटर टूल किसी भी एजेंट थ्रेड के लिए उपलब्ध हो जाते हैं। Zed का MCP समर्थन v0.165 या बाद का संस्करण चाहता है।
VS Code में Cline एक्सटेंशन खोलें → MCP Servers → Edit Configuration। macOS पर सेटिंग्स फ़ाइल ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json पर होती है (Linux/Win पथ समान हैं):
{
"mcpServers": {
"calculatorlib": {
"url": "https://calculatorlib.com/mcp",
"transportType": "streamableHttp"
}
}
}
Cline सर्वर कॉन्फ़िग को स्वतः फिर से लोड कर लेता है; नए टूल कुछ ही सेकंड में MCP पैनल में दिख जाते हैं।
Windsurf खोलें → Cascade → Configure MCP, या ~/.codeium/windsurf/mcp_config.json को सीधे संपादित करें:
{
"mcpServers": {
"calculatorlib": {
"serverUrl": "https://calculatorlib.com/mcp"
}
}
}
Windsurf को फिर से शुरू करें और कैलकुलेटर टूल Cascade के टूल पिकर में आ जाते हैं। HTTP ट्रांसपोर्ट के लिए Windsurf 1.5+ चाहिए।
Streamable HTTP ट्रांसपोर्ट (स्पेक संस्करण 2025-06-18) का समर्थन करने वाला कोई भी MCP-अनुरूप क्लाइंट कनेक्ट कर सकता है:
{
"transport": "streamable-http",
"endpoint": "https://calculatorlib.com/mcp"
}
या curl से JSON-RPC एंडपॉइंट को सीधे कॉल करें:
curl -X POST https://calculatorlib.com/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
ये प्रॉम्प्ट आज़माएँ
इंस्टॉल करने के बाद, बस सामान्य भाषा में Claude से बात करें — वह सही टूल चुन लेता है।
“यदि मेरा वज़न 70 kg और कद 170 cm है तो मेरा BMI क्या है? क्या मैं स्वस्थ सीमा में हूँ?”
Claude bmi_calculator को कॉल करता है और WHO श्रेणी के साथ BMI 24.22 लौटाता है।
“5 मीटर को फ़ीट में, फिर 200 पाउंड को किलोग्राम में बदलो।”
Claude बारी-बारी से convert_length और convert_mass को कॉल करता है।
“यदि मैं $10 000 को 5% वार्षिक चक्रवृद्धि पर 20 साल निवेश करूँ, तो अंतिम मूल्य क्या होगा?”
Claude compound_interest_calculator को कॉल करता है और ब्योरा दिखाता है।
“6.5% ब्याज पर 30 साल के $300k गृह ऋण की मासिक किस्त कितनी है?”
Claude मूलधन, ब्याज दर और अवधि के साथ home_loan_calculator को कॉल करता है।
लाइव प्लेग्राउंड
सर्वर को यहीं से कॉल करें — https://calculatorlib.com/mcp पर असली JSON-RPC, असली प्रतिक्रियाएँ। साइन-अप नहीं।
प्राधिकरण टोकन (वैकल्पिक)
कच्चा JSON-RPC अनुरोध & प्रतिक्रिया
npx @modelcontextprotocol/inspector चलाएँ, फिर https://calculatorlib.com/mcp से कनेक्ट करें (ट्रांसपोर्ट: Streamable HTTP)। टूल ब्राउज़र
कैलकुलेटर लाइब्रेरी और 67 कन्वर्टर श्रेणियों को नाम या शीर्षक से खोजें। Claude से क्या पूछना है यह तय करते समय उपयोगी।
यह कैसे काम करता है
- एंडपॉइंट:
https://calculatorlib.com/mcpपर एक हीPOSTहैंडलर, जो Streamable HTTP पर JSON-RPC 2.0 बोलता है (ट्रांसपोर्ट स्पेक2025-06-18)। - टूल नामकरण: कैलकुलेटर स्लग snake_case उपयोग करते हैं (
bmi_calculator,compound_interest_calculator); कन्वर्टरconvert_<category>होते हैं। - इनपुट: हर टूल कैलकुलेटर के फ़ॉर्म फ़ील्ड (टाइप, enum, min/max) से व्युत्पन्न एक JSON Schema प्रदान करता है। सशर्त फ़ील्ड (उदा. BMI में मीट्रिक बनाम इम्पीरियल) वैकल्पिक के रूप में सूचीबद्ध होते हैं — कौन-से संयोजन मान्य हैं यह जानने के लिए हर फ़ील्ड का विवरण पढ़ें।
- आउटपुट: एक पंक्ति का टेक्स्ट सारांश और साथ में एक
structuredContentJSON ऑब्जेक्ट जिसे LLM पार्स कर सकता है (उदा.{ "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 सेकंड)
- साइन इन करें (या पहले खाता बनाएँ)।
- /account/api-tokens पर जाएँ।
- Generate token पर क्लिक करें। मान कॉपी कर लें — यह केवल एक बार दिखता है।
इसे अपने MCP क्लाइंट में जोड़ें
सार्वजनिक इंस्टॉल वाली वही कॉन्फ़िग फ़ाइल, साथ में एक headers.Authorization फ़ील्ड:
{
"mcpServers": {
"calculatorlib": {
"url": "https://calculatorlib.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
ऐसा क्यों करें?
- व्यक्तिगत उपयोग लॉग — आप कौन-से कैलकुलेटर सबसे ज़्यादा कॉल करते हैं और कौन-से विफल होते हैं, यह केवल अपने टोकन के दायरे में देखें (/account/mcp-logs)।
- कई क्लाइंट, अलग-अलग टोकन — हर डिवाइस (लैपटॉप, सर्वर, एजेंट) के लिए एक बनाएँ। एक को रद्द करने से बाकी पर असर नहीं पड़ता।
- भविष्य की प्रति-उपयोगकर्ता सुविधाओं की नींव — जब हम रेट लिमिट / कोटा / सहेजे गए प्रीसेट जोड़ेंगे, वे प्रमाणित कॉल से जुड़ेंगे।
Bearer टोकन के साथ curl
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 एनवायरनमेंट वेरिएबल एकल साझा-गुप्त बायपास के रूप में अब भी काम करता है।
सामान्य प्रश्न & समस्या निवारण
क्या यह निःशुल्क है? क्या कोई रेट लिमिट है?
क्या आप मेरी क्वेरी संग्रहीत करते हैं?
Claude कभी-कभी क्यों कहता है कि किसी टूल ने कोई उपयोगी डेटा नहीं लौटाया?
क्या मैं प्रमाणित कर सकता हूँ ताकि मेरा उपयोग मेरे खाते में दिखे?
/mcp अनुरोध पर Authorization: Bearer <token> के रूप में भेजें और आपकी कॉल /account/mcp-logs पर दिखेंगी। पूरी क्लाइंट कॉन्फ़िग के लिए ऊपर प्रमाणीकरण अनुभाग देखें।मेरा टोकन खो गया। क्या मैं इसे पुनर्प्राप्त कर सकता हूँ?
मैंने अभी एक नया कैलकुलेटर प्रकाशित किया — यह कब दिखेगा?
टूल का नाम उस स्लग से मेल नहीं खाता जो मैं URL में देखता हूँ?
/bmi-calculator, bmi_calculator बन जाता है।