Calculator Mcp Server

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:

``bash git clone https://github.com/mvavassori/calculator-mcp-server.git ``

1. Navigate into the project directory:

``bash cd calculator-mcp-server ``

1. Install dependencies:

``bash npm install ``

Building the Server

• Build the TypeScript code:

``bash 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.

1. Edit the Configuration File: Open the claude_desktop_config.json file in a text editor.

1. 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:

``json { "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.

1. 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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mvavassori
• Source: mvavassori/calculator-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.