Skip to main content
Glama
calc_mcp

calc_mcp

by nocodig

calc_mcp

MCP-сервис калькулятора, предоставляющий через stdio четыре арифметические операции: сложение, вычитание, умножение и деление.

Использует API FastMCP из официального MCP Python SDK; зависимости ограничены версией 1.x, чтобы избежать изменений интерфейса при обновлении между основными версиями.

Доступные инструменты

Все инструменты принимают два обязательных числовых параметра — a и b; поддерживаются целые числа, десятичные дроби и отрицательные числа.

Инструмент

Операция

Пример аргументов вызова

Результат

add

a + b

{"a": 2, "b": 3}

5.0

subtract

a - b

{"a": 2, "b": 5}

-3.0

multiply

a * b

{"a": -3, "b": 4}

-12.0

divide

a / b

{"a": 7, "b": 2}

3.5

При успешном вызове structuredContent равен {"result": 数值}; также возвращается совместимое текстовое содержимое. Инструменты не читают и не записывают файлы и не обращаются к сети.

Ошибки возвращаются в результате инструмента MCP с isError: true и не прерывают работу сервиса:

  • Делитель равен 0 или -0.0: Cannot divide by zero.

  • Аргумент равен NaN или бесконечности: Operands must be finite numbers.

  • Результат переполняется, превращаясь в бесконечность: Result exceeds the supported finite number range.

  • Отсутствуют аргументы или передано значение, которое невозможно разобрать как число: SDK возвращает ошибку проверки параметров.

Вычисления используют числа с плавающей запятой двойной точности Python, поэтому возможны обычные ошибки округления; например, 0.1 + 0.2 может вернуть 0.30000000000000004. Сервис не предназначен для сценариев, требующих точных десятичных вычислений; данная версия не поддерживает вычисление выражений.

Related MCP server: My Calculator MCP Server

Структура каталога

calc_mcp/
├── pyproject.toml          # 项目、依赖和命令行入口
├── uv.lock                 # 依赖版本锁定
├── README.md
├── .gitignore
├── src/calc_mcp/
│   ├── __init__.py
│   ├── __main__.py         # python -m calc_mcp 入口
│   ├── server.py           # MCP 实例和 stdio 启动
│   └── tools.py            # 四则运算、边界检查和工具注册
└── tests/
    └── test_server.py      # 算术单元测试和 stdio 集成测试

Установка и запуск

Требуются Python 3.10+ и uv. Выполните в каталоге проекта:

uv sync
uv run calc-mcp

Также можно запустить через точку входа модуля:

uv run python -m calc_mcp

Сервис взаимодействует с MCP-клиентом через стандартный ввод/вывод и не предоставляет веб-интерфейс. После прямого запуска ожидание сообщений от клиента — нормальное явление. Не выводите отладочную информацию в stdout; журналы следует записывать в stderr.

Пример конфигурации MCP-клиента

Нижеприведённое подходит для клиентов, использующих формат JSON-конфигурации mcpServers; адаптируйте под конкретного клиента:

{
  "mcpServers": {
    "calc-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/lifang/product/0826/calc_mcp",
        "run",
        "calc-mcp"
      ]
    }
  }
}

Если клиент не находит uv, замените command на абсолютный путь к исполняемому файлу uv. После перемещения проекта необходимо обновить путь к каталогу.

Проверка

uv run python -m unittest discover -s tests -v

Тесты охватывают четыре арифметических действия, отрицательные числа, десятичные дроби, ноль, недопустимые аргументы, неконечные числа и переполнение; также запускается реальный дочерний процесс stdio для проверки инициализации MCP, обнаружения инструментов, вызова инструментов и корректного вызова после ошибки.

Места для дальнейшего расширения

Добавляйте определения инструментов в src/calc_mcp/tools.py и включайте функции в список регистрации register_tools(). create_server() из server.py единообразно регистрирует все инструменты.

Available Tools

4 tools
addA
Read-onlyIdempotent

Add two finite numbers: a + b.

Inputs: a (required), b (required). Returns: result

divideA
Read-onlyIdempotent

Divide a by b: a / b. Operands must be finite and b must not be zero.

Inputs: a (required), b (required). Returns: result

multiplyA
Read-onlyIdempotent

Multiply two finite numbers: a * b.

Inputs: a (required), b (required). Returns: result

subtractA
Read-onlyIdempotent

Subtract b from a: a - b. Both operands must be finite numbers.

Inputs: a (required), b (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool maps to a single, distinct arithmetic operation: addition, subtraction, multiplication, or division. There is no overlap or ambiguity between tool purposes.

    Naming Consistency5/5

    All tool names follow the same simple verb-only pattern: add, subtract, multiply, divide. The naming is perfectly consistent and instantly predictable.

    Tool Count5/5

    Four tools is the ideal size for a basic arithmetic calculator server. Each tool covers a fundamental operation without unnecessary bloat.

    Completeness5/5

    The tool set fully covers the core arithmetic operations needed for a calculator: addition, subtraction, multiplication, and division, with appropriate edge-case handling for division by zero. It is a complete minimal surface for its stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      Provides basic mathematical operations (addition, subtraction, multiplication, division) through a calculate tool. Supports both stdio and HTTP/SSE transport modes.
      1
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes add, subtract, multiply, and divide tools for performing arithmetic operations over stdio via the Model Context Protocol.
      ISC
    • F
      license
      A
      quality
      C
      maintenance
      Enables an LLM client to perform basic arithmetic on two numbers — addition, subtraction, multiplication, and division — plus reverse a supplied text string, through five simple tools exposed over stdio. Inputs and structured text results follow JSON schemas, with invalid operations such as division by zero surfaced as tool errors.
      5
      -