MCP Calculator Server

This project is a simple Model Context Protocol (MCP) server that evaluates mathematical expressions sent by MCP clients. It can be used with the official MCP Python client or the VSCode MCP extension.

Features

Evaluate math expressions using Python's math module (e.g., sqrt(25) + 2**3).
Secure evaluation: only math functions/constants are available.
Exposes a calculate tool via the MCP protocol.
Compatible with the Model Context Protocol VSCode extension.

Setup

Clone the repository and enter the directory:
git clone <your-repo-url> cd calculator-mcp
Create and activate a virtual environment (recommended):
python3 -m venv venv source venv/bin/activate
Install dependencies:
pip install -r requirements.txt

Running the MCP Server

Start the server (by default, it listens on all interfaces at port 8500, root path):

python app.py

You should see:

MCP server running on 0.0.0.0:8500 (root path)

Using the Python Client

The provided client.py can be used to test the server:

python client.py

This will send the expression sqrt(25) + 2**3 to the server and print the result.

You can modify client.py to send other expressions.

Using the MCP Server in VSCode

Install the MCP Extension:
- Open VSCode.
- Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X).
- Search for Model Context Protocol or MCP and install the official extension.
Start the MCP server:
- Make sure python app.py is running.
Connect VSCode to the MCP Server:
- Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
- Type MCP: Add Server or MCP: Connect to Server.
- Enter the server URL:
  http://127.0.0.1:8500/
- Give it a name (e.g., "Calculator MCP").
Use the MCP Tools in VSCode:
- Open the MCP sidebar (look for the MCP icon).
- Select your server.
- You should see the calculate tool.
- Run the tool, enter a math expression, and see the result in VSCode.

Security Note

Only math functions/constants are available to evaluated expressions.
No access to Python built-ins or the file system.

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A simple Model Context Protocol server that evaluates mathematical expressions like 'sqrt(25) + 2**3' sent by MCP clients, with secure evaluation that only allows math functions/constants.

Related MCP Servers

Calculator MCP Server
githejie
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to perform precise numerical calculations by evaluating mathematical expressions.
Last updated -
1
98
Python
MIT License
MCP Calculator Server
githubpradeep
A
security
F
license
A
quality
A simple Model Context Protocol server that provides basic arithmetic operations (addition, subtraction, multiplication, division) as tools that can be called by Large Language Models.
Last updated -
4
JavaScript
Calculator MCP
wrtnlabs
A
security
A
license
A
quality
A Model Context Protocol server that provides basic calculator functionality for LLMs, enabling them to perform mathematical operations like addition, subtraction, multiplication, division, modulo, and square root.
Last updated -
6
72
14
TypeScript
MIT License
Calculator MCP Server
mzdz
-
security
F
license
-
quality
Provides basic arithmetic operations and advanced mathematical functions through the Model Context Protocol (MCP), with features like calculation history tracking and expression evaluation.
Last updated -
Python

View all related MCP servers

MCP Calculator Server