Summary
Exposes six calculator operations as MCP tools: add, subtract, multiply, divide, power, and sqrt. Each operation takes numeric parameters and returns formatted results like "5 + 3 = 8" or "2^8 = 256". Includes basic error handling for division by zero and negative square roots. You'd reach for this as a simple reference implementation when learning to build MCP servers or testing client integrations. The TypeScript source is straightforward, making it easy to fork and extend with additional mathematical operations. Runs via stdio transport and integrates with Claude Desktop through a standard node command configuration.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Tools
Public tool metadata for what this MCP can expose to an agent.
1 tools
calculateEvaluate math expressions, simplify algebraic expressions, or compute symbolic derivatives. Supports arithmetic, trigonometry, statistics, matrices, complex numbers, units, and combinatorics.5 params
Evaluate math expressions, simplify algebraic expressions, or compute symbolic derivatives. Supports arithmetic, trigonometry, statistics, matrices, complex numbers, units, and combinatorics.
Parameters* required
expressionstringMathematical expression to evaluate. Supports standard notation: arithmetic (+, -, *, /, ^, %), functions (sin, cos, sqrt, log, abs, round, etc.), constants (pi, e, phi, i), matrices ([1, 2; 3, 4])...
operationstringOperation to perform. "evaluate" computes a numeric result (default). "simplify" reduces an algebraic expression symbolically (e.g., "2x + 3x" -> "5 * x"). Supports algebraic and trigonometric iden...one of
evaluate · simplify · derivativedefault: evaluateprecisionvalueSignificant digits (1–16) for numeric results. Omit for full precision. Blank values from form-based clients are treated as omitted. Ignored for symbolic operations (simplify, derivative).
scopeobjectVariable assignments for the expression. Example: { "x": 5, "y": 3 } makes "x + y" evaluate to 8.
variablevalueVariable to differentiate with respect to. Required when operation is "derivative". Blank values from form-based clients are treated as omitted. Example: "x".
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:
npm install
- Build the TypeScript code:
npm run build
Usage
Running the Server
Start the MCP server:
npm start
Or run in development mode:
npm run dev
MCP Client Configuration
To use this calculator MCP server with an MCP client (like Claude Desktop), add it to your MCP configuration:
{
"mcpServers": {
"calculator": {
"command": "node",
"args": ["/path/to/calculator-mcp/dist/index.js"],
"env": {}
}
}
}
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 = 5 - Error 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 = 4 - Error handling: Returns error for negative numbers
Development
Project Structure
calculator-mcp/
├── src/
│ └── index.ts # Main MCP server implementation
├── dist/ # Compiled JavaScript output
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
└── README.md # This file
Building
npm run build
Development Mode
npm run dev
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
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →