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, выведенную из полей формы калькулятора (тип, перечисление, мин/макс). Условные поля (например, метрические vs имперские в ИМТ) перечислены как необязательные — читайте описание каждого поля, чтобы понять, какие комбинации допустимы.
• Выходные данные: однострочное текстовое резюме плюс JSON-объект structuredContent, который 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 секунд)

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 по-прежнему работает как обход через единый общий секрет.

ЧаВо & устранение неполадок