Calculator MCP Server
A simple Model Context Protocol (MCP) server that provides basic calculator functionality through MCP tools.
Features
This MCP server provides the following calculator tools:
add: Add two numbers together
subtract: Subtract second number from first number
multiply: Multiply two numbers together
divide: Divide first number by second number (with zero-division protection)
power: Raise first number to the power of second number
sqrt: Calculate square root of a number (with negative number protection)
Installation
Install dependencies:
Build the TypeScript code:
Usage
Running the Server
Start the MCP server:
Or run in development mode:
MCP Client Configuration
To use this calculator MCP server with an MCP client (like Claude Desktop), add it to your MCP configuration:
Available Tools
add
Adds two numbers together.
Parameters:
a(number),b(number)Example:
add(5, 3)returns5 + 3 = 8
subtract
Subtracts the second number from the first.
Parameters:
a(number),b(number)Example:
subtract(10, 4)returns10 - 4 = 6
multiply
Multiplies two numbers together.
Parameters:
a(number),b(number)Example:
multiply(6, 7)returns6 × 7 = 42
divide
Divides the first number by the second.
Parameters:
a(number),b(number)Example:
divide(15, 3)returns15 ÷ 3 = 5Error handling: Returns error for division by zero
power
Raises the base to the power of the exponent.
Parameters:
base(number),exponent(number)Example:
power(2, 8)returns2^8 = 256
sqrt
Calculates the square root of a number.
Parameters:
number(number)Example:
sqrt(16)returns√16 = 4Error handling: Returns error for negative numbers
Development
Project Structure
Building
Development Mode
Error Handling
The calculator includes proper error handling for:
Division by zero
Square root of negative numbers
Invalid tool names
General execution errors
All errors are returned with appropriate error messages and the isError flag set to true.
License
MIT
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides basic mathematical calculation functionality through MCP tools including arithmetic operations, exponentiation, and square root calculations. Features proper error handling for edge cases like division by zero and negative square roots.