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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
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".
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 identities. "derivative" computes the symbolic derivative (requires the variable parameter).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).
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]), units (5 kg to lbs), and variables (when scope is provided).
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
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →