MCP Math Server
The MCP Math Server provides comprehensive mathematical operations, comparison tools, and a greeting resource for AI assistants and tool integrations.
Mathematical Operations:
Basic arithmetic: addition, subtraction, multiplication, and division (with division-by-zero error handling)
Advanced functions: square and square root calculations (with negative input error handling and results rounded to two decimals)
Number theory: Greatest Common Measure (GCM/GCD) and Least Common Multiple (LCM) calculations
Comparison Tools:
Less than, greater than, less than or equal, and greater than or equal operations
General comparison returning -1, 0, or 1 with descriptive results
Additional Features:
Personalized greeting functionality that returns "Hello, {name}!"
Type-safe implementation using Zod schemas for input validation
Comprehensive error handling for edge cases
Extensible architecture for adding more tools and resources
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Math Server what's the square root of 25?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Math Server
A Model Context Protocol (MCP) server built with TypeScript and Node.js, designed to provide basic math operations and a greeting resource for AI assistants and tool integrations.
Features
Addition, Subtraction, Multiplication, Division (with division-by-zero error handling)
Square and Square Root (with error handling for negative input, and results rounded to two decimals)
Greatest Common Measure (GCM) and Least Common Multiple (LCM)
Number Comparison tools (less than, greater than, less than or equal, greater than or equal, general comparison)
Greeting resource (returns a personalized greeting)
Fully type-safe using Zod schemas
Easily extensible for more tools/resources
Related MCP server: Calculator MCP Server
Installation
Clone the repository or copy the project files.
Install dependencies:
npm installCompile the TypeScript code:
npx tsc
Running the Server
This project is designed to run as an MCP server using VS Code's MCP integration.
Ensure your
.vscode/mcp.jsonis configured as follows:{ "servers": { "my-mcp-server-d95b22f0": { "type": "stdio", "command": "node", "args": ["d:/Proj/3/mcp-demo/dist/index.js"] } }, "inputs": [] }Start VS Code and ensure the MCP extension is enabled. The server will start automatically.
Available Tools
add: Add two numbers
Input:
{ a: number, b: number }Output:
The sum of a and b is result
subtract: Subtract b from a
Input:
{ a: number, b: number }Output:
The difference of a and b is result
multiply: Multiply two numbers
Input:
{ a: number, b: number }Output:
The product of a and b is result
divide: Divide a by b
Input:
{ a: number, b: number }Output:
The quotient of a divided by b is result(error if b = 0)
square: Square a number
Input:
{ a: number }Output:
The square of a is result
sqrt: Square root of a number
Input:
{ x: number }Output:
The square root of x is result(rounded to two decimals, error if x < 0)
gcm: Greatest Common Measure of two numbers
Input:
{ a: number, b: number }Output:
The greatest common measure of a and b is result
lcm: Least Common Multiple of two numbers
Input:
{ a: number, b: number }Output:
The LCM of a and b is result
lessThan: Compare if a is less than b
Input:
{ a: number, b: number }Output:
a is less than bora is not less than b
greaterThan: Compare if a is greater than b
Input:
{ a: number, b: number }Output:
a is greater than bora is not greater than b
lessThanOrEqual: Compare if a is less than or equal to b
Input:
{ a: number, b: number }Output:
a is less than or equal to bora is not less than or equal to b
greaterThanOrEqual: Compare if a is greater than or equal to b
Input:
{ a: number, b: number }Output:
a is greater than or equal to bora is not greater than or equal to b
compare: General comparison tool
Input:
{ a: number, b: number }Output:
Comparison result: -1, 0, or 1with description
Greeting Resource
greet: Returns a greeting for a given name
Resource URI:
greet://{name}Output:
Hello, {name}!
Example Usage
Add:
{ a: 2, b: 3 }→The sum of 2 and 3 is 5Subtract:
{ a: 10, b: 5 }→The difference of 10 and 5 is 5Multiply:
{ a: 4, b: 6 }→The product of 4 and 6 is 24Divide:
{ a: 8, b: 2 }→The quotient of 8 divided by 2 is 4Square:
{ a: 7 }→The square of 7 is 49Square Root:
{ x: 5 }→The square root of 5 is 2.24GCM:
{ a: 12, b: 18 }→The greatest common measure of 12 and 18 is 6LCM:
{ a: 2, b: 5 }→The LCM of 2 and 5 is 10Less Than:
{ a: 3, b: 5 }→3 is less than 5Greater Than:
{ a: 7, b: 4 }→7 is greater than 4Less Than or Equal:
{ a: 5, b: 5 }→5 is less than or equal to 5Greater Than or Equal:
{ a: 8, b: 3 }→8 is greater than or equal to 3Compare:
{ a: 2.5, b: 3.7 }→Comparison result: -1 (2.5 is less than 3.7)Greeting:
greet://Alice→Hello, Alice!
Extending the Project
You can easily add more tools or resources by registering them in src/index.ts using the MCP SDK and Zod schemas.
License
MIT
Available Tools
8 toolsaddAddition toolA
Add two numbers a + b
Inputs: a (required), b (required).
divideDivision toolC
Divide a by b (a / b)
Inputs: a (required), b (required).
gcmGCM toolA
Calculate the greatest common measure (GCD) of two numbers
Inputs: a (required), b (required).
lcmLCM toolA
Calculate the least common multiple of two numbers
Inputs: a (required), b (required).
multiplyMultiplication toolC
Multiply two numbers a * b
Inputs: a (required), b (required).
sqrtSquare Root toolA
Calculate the square root of a number (rounded to two decimals)
Inputs: x (required).
squareSquare toolC
Calculate the square of a number
Inputs: a (required).
subtractSubtraction toolB
Subtract b from a (a - b)
Inputs: a (required), b (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Every tool has a clearly distinct mathematical operation with no overlap in purpose. The descriptions specify unique functions like addition, division, GCD, LCM, multiplication, square root, squaring, and subtraction, making misselection highly unlikely.
The naming is mostly consistent with a simple verb-based pattern (e.g., add, divide, multiply, subtract), but there are minor deviations: 'gcm' and 'lcm' use acronyms instead of full names, and 'sqrt' is an abbreviation, which slightly breaks the pattern while remaining readable.
With 8 tools, the server is well-scoped for a basic math utility, covering essential arithmetic and number theory operations. Each tool earns its place without redundancy, and the count is neither too sparse nor overwhelming for the domain.
The tool set covers core arithmetic operations (add, subtract, multiply, divide) and key number theory functions (GCD, LCM, square, square root), with minor gaps such as lacking advanced operations like exponentiation or trigonometric functions, but agents can work around this for basic math tasks.
Maintenance
Related MCP Connectors
500+ deterministic tools for AI agents: math, conversion, validation, hashing, encoding, date/time.
Unofficial Math.js MCP — wraps the mathjs.org API (free, no auth)
Exact arithmetic, algebra, calculus, physics, chemistry and finance with a checkable formula.
Free deterministic tools for math, data transforms, dates, text, statistics, finance, and units.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides 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.655 npm2MIT
- FlicenseNot gradedqualityDmaintenanceProvides mathematical operation tools including basic arithmetic (add, subtract, multiply, divide), power and square root calculations, and safe evaluation of mathematical expressions.-
- FlicenseNot gradedqualityDmaintenanceProvides mathematical calculation tools including basic operations, expressions, and functions, along with TypeScript SDK documentation resources and meeting summary prompt templates.-
- AlicenseNot gradedqualityDmaintenanceA TypeScript-based MCP server providing utility tools like arithmetic calculations, random number generation, and math tutoring prompts. It enables users to perform basic computational tasks and access system status resources through JSON-RPC 2.0 protocol.16 npmMIT