Calculator MCP Server

Calculator MCP Server

By mvavassori GitHub

A comprehensive calculator MCP server using TypeScript

mathgpt math-solver
Overview

What is Calculator MCP Server?

Calculator MCP Server is a comprehensive calculator implemented as a Model Context Protocol (MCP) server using TypeScript, designed to expose a wide range of mathematical functions for use by language models connected via MCP clients.

How to use Calculator MCP Server?

To use the Calculator MCP Server, clone the repository, install the dependencies, build the TypeScript code, and run the server. Then, connect it to an MCP client like Claude for Desktop by configuring the client’s MCP settings.

Key features of Calculator MCP Server?

  • Basic arithmetic operations (addition, subtraction, multiplication, division)
  • Advanced functions including exponents, roots, trigonometry, and logarithms
  • Support for constants like Pi and Euler's number
  • Factorial and percentage calculations
  • Modulo and absolute value operations
  • Rounding functions (floor, ceiling, round)

Use cases of Calculator MCP Server?

  1. Performing complex mathematical calculations in real-time.
  2. Integrating with AI language models for enhanced computational capabilities.
  3. Providing a backend for educational tools that require mathematical computations.

FAQ from Calculator MCP Server?

  • What programming language is used for the Calculator MCP Server?

The server is implemented in TypeScript.

  • Is there a license for the Calculator MCP Server?

Yes, it is licensed under the MIT License.

  • How can I connect the server to Claude for Desktop?

You need to edit the MCP configuration file of Claude to include the server's command and path.

Content

Calculator MCP Server

A comprehensive calculator implemented as a Model Context Protocol (MCP) server using TypeScript.

This server exposes a wide range of mathematical functions as MCP tools, allowing language models connected via MCP clients (like Claude for Desktop, Cursor, etc.) to perform calculations.

Features

Provides MCP tools for:

  • Basic Arithmetic: Addition, Subtraction, Multiplication, Division
  • Exponents & Roots: Power (^), Square Root
  • Trigonometry: Sine, Cosine, Tangent (input in radians)
  • Inverse Trigonometry: Arcsine, Arccosine, Arctangent, Arctan2 (output in radians)
  • Degree/Radian Conversion: Convert between degrees and radians
  • Logarithms: Natural Log (ln), Base-10 Log (log10), Log with arbitrary base
  • Constants: Pi (π), Euler's number (e)
  • Factorial: n!
  • Percentage: Calculate percentage of a number
  • Modulo: Remainder operation
  • Absolute Value: abs()
  • Rounding: Floor, Ceiling, Round to nearest integer

Prerequisites

  • Node.js (v16 or higher recommended)
  • npm (usually included with Node.js)

Installation

  1. Clone the repository:

    git clone https://github.com/mvavassori/calculator-mcp-server.git
    
  2. Navigate into the project directory:

    cd calculator-mcp-server
    
  3. Install dependencies:

    npm install
    

Running the Server

  1. Build the TypeScript code:

    npm run build
    

    This compiles the code into the build directory.

  2. Run the server:

    npm run start
    # OR directly using node:
    # node build/index.js
    

The server will start and listen for MCP connections via standard input/output (stdio). You should see a message like Calculator MCP Server connected via stdio and ready. printed to your terminal's standard error. Keep this terminal window open while using the server with Claude Desktop.

Connecting to Clients (Claude Desktop Example)

This server communicates using the MCP stdio transport. To connect it to Claude for Desktop:

  1. Find Claude Desktop's MCP Configuration File:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json (You can paste this path into the File Explorer address bar).
    • Linux: ~/.config/Claude/claude_desktop_config.json
    • If the file or the Claude directory doesn't exist, you might need to create it, or open Claude Desktop's Settings (Claude Menu > Settings... > Developer > Edit Config) which should create the file for you.
  2. Edit the Configuration File: Open the claude_desktop_config.json file in a text editor.

  3. Add the Server Configuration: Modify the file to include the mcpServers object with your calculator server entry. If the file was empty or didn't exist, its entire content should look like this:

    {
      "mcpServers": {
        "calculator": {
          "command": "node",
          "args": [
            "/home/marco/code/calculator-mcp-server/build/index.js"
            // IMPORTANT: Replace this path with the ACTUAL ABSOLUTE PATH
            // to the 'build/index.js' file on YOUR system.
          ]
        }
        // You can add other servers here under different keys, like:
        // "another_server": { ... }
      }
    }
    

    Notes:

    • CRITICAL: Replace /home/marco/code/calculator-mcp-server/build/index.js with the correct absolute path to the build/index.js file within your cloned project directory on your computer.
    • On Windows, use double backslashes (\\) for the path separators, e.g., "C:\\Users\\YourUser\\path\\to\\calculator-mcp-server\\build\\index.js".
    • The key "calculator" is just a name you give this server connection within Claude's config; it can be anything descriptive.
    • If the mcpServers object already exists, just add the "calculator": { ... } entry inside it, separated by a comma if other servers are present.
  4. Restart Claude for Desktop: Ensure Claude for Desktop is fully closed and reopened for the new configuration to take effect.

Claude for Desktop should now show the MCP tools icon (a hammer ) and be able to use the calculator tools when you ask it to perform calculations.

License

MIT License

No tools information available.

-

mathgpt math-solver
View Details
StatSource
StatSource by jamie7893

Statsource is a standalone MCP server designed to simplify data analysis. Whether you're pulling data from a PostgreSQL database or a CSV file, Statsource delivers actionable insights with ease

mathgpt math-solver
View Details

Mirror of

mathgpt math-solver
View Details

created from MCP server demo

mathgpt math-solver
View Details

-

mathgpt math-solver
View Details

created from MCP server demo

mathgpt math-solver
View Details