CalculatorLib MCP

Installation en 60 secondes

Choisissez votre client, collez l’extrait, redémarrez. C’est tout.

Claude Code Claude Desktop Cursor Zed Cline Windsurf Autre / générique

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

Essayez ces requêtes

Après l’installation, parlez simplement à Claude en langage naturel — il choisit le bon outil.

Bac à sable en direct

Appelez le serveur ici même — du vrai JSON-RPC vers https://calculatorlib.com/mcp, de vraies réponses. Sans inscription. chargement des outils…

Explorateur d’outils

Recherchez dans la bibliothèque de calculatrices et les 9 catégories de convertisseurs par nom ou par titre. Utile pour découvrir quoi demander à Claude.

Comment ça marche

• Point de terminaison : un unique gestionnaire POST à https://calculatorlib.com/mcp parlant JSON-RPC 2.0 sur Streamable HTTP (spéc de transport 2025-06-18).
• Nommage des outils : les slugs de calculatrices utilisent le snake_case (bmi_calculator, compound_interest_calculator) ; les convertisseurs sont convert_<category>.
• Entrées : chaque outil publie un JSON Schema dérivé des champs du formulaire de la calculatrice (type, énumération, min/max). Les champs conditionnels (par ex. métrique vs impérial pour l’IMC) sont listés comme facultatifs — lisez la description de chaque champ pour savoir quelles combinaisons sont valides.
• Sorties : un résumé textuel d’une ligne plus un objet JSON structuredContent que le LLM peut analyser (par ex. { "main": [{...}], "data": [...] }).
• Mises à jour : le catalogue se rafraîchit toutes les 5 minutes — les calculatrices nouvellement publiées apparaissent automatiquement.

API directe (aucun client MCP requis)

Vous voulez intégrer sans client MCP ? Les mêmes données sont disponibles via de simples points de terminaison 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"}
    }
  }'

Points de terminaison REST (sans enveloppe JSON-RPC) :

• /api/calculators/schemas?q=<keywords> — recherche de calculatrices (correspondances limitées avec schémas d’entrée)
• /api/converter/categories — catégories de convertisseurs avec unités
• POST /api/converter/convert — convertisseur direct, corps { category, from, to, value }

Authentification (facultative mais recommandée)

Les appels anonymes fonctionnent — l’authentification est facultative. Ajouter un jeton débloque des statistiques d’utilisation par utilisateur sur /account/mcp-logs : chaque appel effectué via un jeton y apparaît avec la latence, la raison de l’erreur et la calculatrice utilisée.

Obtenir un jeton (60 secondes)

1. Connectez-vous (ou créez un compte d’abord).
2. Allez sur /account/api-tokens.
3. Cliquez sur Generate token. Copiez la valeur — elle n’est affichée qu’une seule fois.

Ajoutez-le à votre client MCP

Le même fichier de configuration que pour l’installation publique, plus un champ headers.Authorization :

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

Pourquoi le faire ?

• Journaux d’utilisation personnels — voyez quelles calculatrices vous appelez le plus et lesquelles échouent, limité à votre seul jeton (/account/mcp-logs).
• Plusieurs clients, jetons distincts — créez-en un par appareil (ordinateur portable, serveur, agent). En révoquer un ne perturbe pas les autres.
• Base pour de futures fonctionnalités par utilisateur — lorsque nous ajouterons des limites de débit / quotas / préréglages enregistrés, ils se rattacheront aux appels authentifiés.

curl avec jeton 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"}'

Opérateurs de serveur : définissez MCP_REQUIRE_AUTH=true pour exiger un jeton à chaque appel (anonyme → 401). L’ancienne variable MCP_API_TOKEN fonctionne encore comme contournement à secret partagé unique.

FAQ & dépannage