What is Calculator Mcp Server

The 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 as MCP tools for connected language models.

Use cases

Use cases include integrating with language models for automated calculations, providing a backend for educational applications, enabling complex mathematical queries in chatbots, and supporting data analysis tasks.

How to use

To use the calculator-mcp-server, clone the repository, navigate to the project directory, install the dependencies, build the TypeScript code, and then run the server to listen for MCP connections.

Key features

Key features include basic arithmetic operations, exponents and roots, trigonometric functions, inverse trigonometric functions, degree/radian conversion, logarithms, mathematical constants, factorial calculations, percentage calculations, modulo operations, absolute value, and rounding functions.

Where to use

The calculator-mcp-server can be used in various fields such as educational tools, programming environments, data analysis, and any application requiring mathematical computations through language models.

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
   

Building the Server

• Build the TypeScript code:

  npm run build
  

  This compiles the code into the build directory.

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:

   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