Log inSubmit server
MCP Server Calculator logo

MCP Server Calculator

by githejie

Evaluates supplied mathematical expressions through one MCP tool for precise numerical results.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server Calculator

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "githejie-mcp-server-calculator": {
      "command": "uvx",
      "args": [
        "mcp-server-calculator"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 1 tools correctly (23d ago).

Overview

githejie/mcp-server-calculator MCP server exposes a calculator to MCP-compatible clients through the `calculate` tool. The tool accepts a required expression string and evaluates it for numerical results. It runs locally with `uvx` or as a Python module after installation with pip. Reach for it when an LLM needs calculations handled by a dedicated calculator rather than inferred in text.

Use cases

  • Evaluate arithmetic expressions submitted by an LLM
  • Delegate numerical calculations to an MCP tool
  • Add calculator access to a local MCP client
  • Run the calculator with uvx or Python

Key features

  • Exposes a single `calculate` MCP tool
  • Accepts a required expression string
  • Evaluates numerical expressions
  • Runs through uvx without separate package installation
  • Supports pip installation and Python module execution

Tools1

What MCP Server Calculator lets your agent do. Expand a tool for its parameters.

Verified live~48 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

6/6 checks healthy over the last 72d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · mcp-server-calculator (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars160Stargazers on the source repository.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed1Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server Calculator works

What githejie/mcp-server-calculator MCP server does

githejie/mcp-server-calculator MCP server gives an MCP-compatible client access to a calculator for evaluating numerical expressions. It is intended for cases where an LLM needs a calculation performed explicitly and returned as a tool result.

The server exposes one documented capability: calculate. Its required input is expression, represented as a string. The project documentation does not describe additional tools, data sources, external integrations, authentication, or persistent state.

How it works

The server is started as a local process that an MCP client can invoke. The client sends an expression to the calculate tool, and the server evaluates it. This keeps the calculation step separate from the model’s conversational response and gives the model a tool for numerical work.

There are two documented ways to launch it:

  • Use uvx to run the package without a separate package installation.
  • Install the package with pip and start it with Python’s module runner.

The repository does not document a network endpoint, API key, configuration file beyond the MCP client entry, or environment variables.

Setup and configuration

For the recommended uv approach, install uv with the project’s provided installation command, then register a server entry that runs uvx with mcp-server-calculator as its argument. The corresponding client configuration uses command: "uvx" and passes the package name through args.

With pip, install the package named mcp-server-calculator. Configure the MCP client to run python with -m mcp_server_calculator. These two launch methods are the only setup paths documented by the project.

No environment variables are required by the documented configuration.

Tools and capabilities

The documented tool is:

  • calculate: evaluates the supplied expression.

Its input is one required field:

  • expression — a string containing the expression to calculate.

The package is a focused choice for numerical expression evaluation. It does not document tools for files, databases, web requests, code execution, or unit conversion, so those use cases are outside the stated scope.

Limitations and notes

githejie/mcp-server-calculator MCP server has a narrow interface: one tool and one required input. Validate expressions and result handling in the target client if those details matter to your workflow.

The documented client configuration launches the server locally, so deployment details beyond local process startup are not covered. The project is licensed under MIT, allowing use, modification, and distribution subject to that license’s terms.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server Calculator

githejie/mcp-server-calculator is an MCP server that connects MCP-compatible clients to a local calculator process. Its main tool, `calculate`, accepts a required string expression and evaluates it for numerical results. The server can run through `uvx` or as the `mcp_server_calculator` Python module.

Install it either with `uv`/`uvx` or with pip. The documented pip command is `pip install mcp-server-calculator`; the alternative runs `uvx mcp-server-calculator` after installing uv.

Add a local MCP server entry that runs either `uvx` with `mcp-server-calculator` or `python` with `-m mcp_server_calculator`. The README provides both command-and-argument configurations.

Cursor can use it if its MCP configuration supports that documented format.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server Calculator AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/githejie-mcp-server-calculator?style=directory)](https://allmcps.com/mcp/githejie-mcp-server-calculator)
HTML Embed
<a href="https://allmcps.com/mcp/githejie-mcp-server-calculator"><img src="https://allmcps.com/api/badge/githejie-mcp-server-calculator?style=directory" alt="MCP Server Calculator on AllMCPs" /></a>