Skip to main content
Glama

MCP Calculator Server

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

  1. Clone the repository and enter the directory:
    git clone <your-repo-url> cd calculator-mcp
  2. Create and activate a virtual environment (recommended):
    python3 -m venv venv source venv/bin/activate
  3. 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

  1. 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.
  2. Start the MCP server:
    • Make sure python app.py is running.
  3. 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").
  4. 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

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Features
    1. Setup
      1. Running the MCP Server
        1. Using the Python Client
          1. Using the MCP Server in VSCode
            1. Security Note
              1. License

                Related MCP Servers

                • 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
                  • Linux
                  • Apple
                • 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
                • 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
                  • Linux
                • -
                  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 directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/linuxacademyir/calculator-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server