Skip to main content
Glama
rubensgomes-org

calculator-mcp

by rubensgomes-org
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Calculator MCP Server

python poetry FastMCP GitHub Microsoft AI license

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

Related MCP server: Simple Calculator MCP Server

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

  1. Install using pip

pip install calculator-mcp-rubens

  1. 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

  1. Run

calculator-mcp

  1. Health check

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

  1. 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 useSonarQube Cloud under its free plan for open-source projects.

License

The project is licensed under the MIT License.

Links

Author: Rubens Gomes

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Calculator Server

    RMahshie
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    A calculator server that exposes mathematical functions as tools (add, subtract, multiply, divide, square, power, square root), enabling language models to perform calculations through Model Context Protocol (MCP).
    -

  • Simple Calculator MCP Server

    KeerthiNingegowda
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables basic arithmetic operations (add, subtract, multiply, divide, modulo) via natural language, with a FastMCP-based server and client for exploring MCP tool calling.
    MIT

  • calculator

    tharunramavath
    A
    license
    Not graded
    quality
    B
    maintenance
    A calculator MCP server built as part of a step-by-step tutorial that demonstrates core MCP primitives—tools, resources, and prompts—and can be upgraded to a live weather server.
    MIT