calculator-mcp

linuxacademyir/calculator-mcp

3.2

If you are the rightful owner of calculator-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP Calculator Server is a simple server that evaluates mathematical expressions using the Model Context Protocol.

Tools
1
Resources
0
Prompts
0

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