calculator-mcp：面向 LLM 智能体的 MCP 计算器服务器

calculator-mcp is an MCP (Model Context Protocol) server that exposes 16 arithmetic operations as callable tools for use by LLMs within agentic applications. It contains no mathematical logic of its own. Instead, each tool is a thin synchronous wrapper that logs its arguments and delegates execution to the open-source calculator-lib package published on PyPI as calculator-lib-rubens.

Features

16 calculator functions exposed through an MCP server for consumption by AI agentic programs:

Two-operand operations: add, subtract, multiply, divide, power, nth_root, modulo, floor_divide
Single-operand operations: sqrt, absolute, floor, ceil, log10, ln, exp
Rounding: round_number (with configurable decimal places)

The following are the supported MCP JSON-RPC 2.0 methods:

Lifecycle Methods: initialize, notifications/initialized
Tools Methods: tools/list, tools/call
Resources Methods: resources/list, resources/templates/list, resources/read
Prompts Methods: prompts/list, prompts/get

The following MCP protocols are supported, selected by the client per request:

Legacy MCP (Version: 2025-06-18): initialize handshake and Mcp-Session-Id session
Modern MCP (Version: 2026-07-28): no handshake or session

Unsupported Features

Unsupported JSON-RPC methods:

Logging & Progress Utilities (e.g. notifications/progress)
Server-to-Client calls (e.g. sampling/createMessage, elicitation/create, roots/list)

AI Disclaimer

This project includes code and documentation created with the assistance of AI tools. For details on usage, limits, and review practices, please see the AI Disclaimer.

Prerequisites

Python 3.14+
pip

Installation

Install using pip

pip install calculator-mcp-rubens

Confirm the installed version matches the latest GitHub release at calculator-mcp/releases

calculator-mcp --version
pip show calculator-mcp-rubens

Uninstall

pip uninstall calculator-mcp-rubens
pip cache purge

Configuration

Copy the file config.yaml to ${HOME}/cfg/calculator-mcp/config.yaml.

export CALCULATORMCP_CONFIG="${HOME}/cfg/calculator-mcp/config.yaml"

Usage

calculator-mcp

Health check

curl -v http://localhost:8080/health
# Expect: OK

To stop, press Ctrl+C in the running terminal

Open Source Project Information

This project is open source and publicly hosted on GitHub at rubensgomes-org. It is published under an OSI-approved open-source license.

Important

Public availability and the use of an OSI-approved license are requirements for eligibility to use SonarQube Cloud under its free plan for open-source projects.

License

The project is licensed under the MIT License.

Links

Author: Rubens Gomes