Skip to main content
Glama
MCP Calculator Server

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.


Related MCP server: MCP Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A minimal Python-based server that provides real-time weather data and a safe mathematical expression evaluator. It enables users to fetch current weather conditions and perform complex calculations using the Model Context Protocol.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A secure MCP server for evaluating mathematical expressions with grammar validation, function whitelisting, and sandboxed execution. It provides tools for expression evaluation, variable management, and resources for grammar and function documentation.
      6
      27 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides basic mathematical, statistical and trigonometric functions to Large Language Models (LLMs).
      59
      1
      MIT