Calculator MCP Server
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-rubens package published on PyPI.
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):
initializehandshake; aMcp-Session-Idis issued only whenstatelessis false inconfig.yaml - Modern MCP (Version: 2026-07-28): no handshake or session
Non-Supported Features
Non-supported JSON-RPC methods:
- Logging & Progress Utilities (e.g.
notifications/progress) - Server-to-Client calls are not supported (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 in
pipdefault installation folder
pip install calculator-mcp-rubens
- Install in the Python user install directory
pip --no-cache-dir install -U --user 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
- Uninstall as follows
pip uninstall calculator-mcp-rubens
pip cache purge
Configuration
- Copy the file
config.yaml
to
${HOME}/cfg/calculator-mcp/config.yaml.
export CALCULATOR_MCP_CONFIG="${HOME}/cfg/calculator-mcp/config.yaml"
Usage
- Simply run
calculator-mcp
- Health check
curl -v http://localhost:8080/health
# Expect: OK
- To stop, go to the running terminal and press
Ctrl+C
License
The project is licensed under MIT License.
Links
- GitHub Project
- Azure CLI Commands
- Azure Container App Provisioning
- Development Setup
- Docker
- Integration Test
- MCP
- Miscellaneous
- OAuth Diagram
- PyCharm
- Release Process
Author: Rubens Gomes
1 maintainer
Metadata
1 maintainer
Release files for calculator-mcp-rubens 0.0.33
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| calculator_mcp_rubens-0.0.33.tar.gz | 12.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| calculator_mcp_rubens-0.0.33-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.7 kB
Release files / calculator_mcp_rubens-0.0.33.tar.gz
| Download URL | calculator_mcp_rubens-0.0.33.tar.gz |
|---|---|
| Size | 12.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a4ec9fd17cc92cc5e70f2cd94dfb7fd4236c7a08649527c3cbcf93c0785b9787
|
|
BLAKE2b-256 checksum How to use checksums |
6032d6f94adc12e2ca9142ab8653c083fb6606cc80ad1c66f27cc59805dc22f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.3 CPython/3.14.7 Linux/6.17.0-1022-azure
|
Release files / calculator_mcp_rubens-0.0.33-py3-none-any.whl
| Download URL | calculator_mcp_rubens-0.0.33-py3-none-any.whl |
|---|---|
| Size | 19.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cf0c123f03df515783c6e664c3b66feef55a8a7c9d5d4786457c7995af0bc5d0
|
|
BLAKE2b-256 checksum How to use checksums |
e458fdc9b63282fd2606652f5ed0faa6afc73ba909b9fd3f8998e2b40d6613b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.3 CPython/3.14.7 Linux/6.17.0-1022-azure
|
