CalculatorLib MCP

60 saniyede kurulum

Kullandığınız istemciyi seçin, snippet’i yapıştırın, yeniden başlatın. Hepsi bu.

Claude Code Claude Desktop Cursor Zed Cline Windsurf Diğer / genel

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"}'

Şu istemleri deneyin

Kurduktan sonra Claude ile gündelik dilde konuşmanız yeterli — doğru aracı kendisi seçer.

Canlı deneme alanı

Sunucuyu tam buradan çağırın — https://calculatorlib.com/mcp adresine gerçek JSON-RPC, gerçek yanıtlar. Kayıt yok. araçlar yükleniyor…

Araç tarayıcısı

Hesaplayıcı kütüphanesinde ve 9 dönüştürücü kategorisinde ada veya başlığa göre arama yapın. Claude’dan ne isteyeceğinizi keşfederken kullanışlıdır.

Nasıl çalışır

• Uç nokta: https://calculatorlib.com/mcp adresinde, Streamable HTTP üzerinden JSON-RPC 2.0 konuşan tek bir POST işleyicisi (taşıma spesifikasyonu 2025-06-18).
• Araç adlandırma: hesaplayıcı slug’ları snake_case kullanır (bmi_calculator, compound_interest_calculator); dönüştürücüler convert_<category> biçimindedir.
• Girdiler: her araç, hesaplayıcının form alanlarından (tür, enum, min/maks) türetilen bir JSON Schema sunar. Koşullu alanlar (ör. VKİ’de metrik ve emperyal) isteğe bağlı olarak listelenir — hangi kombinasyonların geçerli olduğunu öğrenmek için her alanın açıklamasını okuyun.
• Çıktılar: tek satırlık bir metin özeti ile birlikte LLM’nin ayrıştırabileceği bir structuredContent JSON nesnesi (ör. { "main": [{...}], "data": [...] }).
• Güncellemeler: katalog her 5 dakikada bir yenilenir — yeni yayımlanan hesaplayıcılar otomatik olarak görünür.

Doğrudan API (MCP istemcisi gerekmez)

MCP istemcisi olmadan entegre etmek mi istiyorsunuz? Aynı veriler sade JSON uç noktalarıyla da sunulur.

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 uç noktaları (JSON-RPC sarmalayıcısı olmadan):

• /api/calculators/schemas?q=<keywords> — hesaplayıcı arama (girdi şemalarıyla sınırlı eşleşmeler)
• /api/converter/categories — birimleriyle dönüştürücü kategorileri
• POST /api/converter/convert — doğrudan dönüştürücü, gövde { category, from, to, value }

Kimlik doğrulama (isteğe bağlı ama önerilir)

Anonim çağrılar çalışır — kimlik doğrulama tercihe bağlıdır. Bir jeton eklemek /account/mcp-logs adresinde kullanıcı bazlı kullanım analizlerini açar: bir jetonla yaptığınız her çağrı; gecikme, hata nedeni ve çağırdığınız hesaplayıcıyla birlikte orada görünür.

Jeton alın (60 saniye)

1. Oturum açın (ya da önce bir hesap oluşturun).
2. /account/api-tokens sayfasına gidin.
3. Generate token’a tıklayın. Değeri kopyalayın — yalnızca bir kez gösterilir.

MCP istemcinize ekleyin

Herkese açık kurulumla aynı yapılandırma dosyası, ayrıca bir headers.Authorization alanı:

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

Neden uğraşmalı?

• Kişisel kullanım günlükleri — en çok hangi hesaplayıcıları çağırdığınızı ve hangilerinin başarısız olduğunu, yalnızca kendi jetonunuzla sınırlı olarak görün (/account/mcp-logs).
• Birden çok istemci, ayrı jetonlar — her cihaz için (dizüstü, sunucu, ajan) bir tane oluşturun. Birini iptal etmek diğerlerini etkilemez.
• Gelecekteki kullanıcı bazlı özelliklerin temeli — hız limitleri / kotalar / kayıtlı ön ayarlar eklediğimizde, bunlar kimliği doğrulanmış çağrılara bağlanır.

Bearer jetonuyla 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"}'

Sunucu operatörleri: her çağrı için jeton zorunlu kılmak üzere MCP_REQUIRE_AUTH=true ayarlayın (anonim → 401). Eski MCP_API_TOKEN ortam değişkeni tek bir paylaşılan gizli anahtar atlama yöntemi olarak çalışmaya devam eder.

SSS & sorun giderme