Math-MCP

Math-MCP

A Model Context Protocol (MCP) server that provides basic mathematical, statistical and trigonometric functions to Large Language Models (LLMs). This server enables LLMs to perform accurate numerical calculations through a simple API.

Features

• Basic arithmetic operations (addition, subtraction, multiplication, division, sum, modulo)
• Statistical functions (mean, median, mode, min, max)
• Rounding functions (floor, ceiling, round)
• Trigonometric functions (sin, cos, tan, and their inverses; degrees/radians conversions)

Installation

Note: Ensure you have Node.js installed on your computer.

Just clone this repository and save it locally somewhere on your computer.

Then add this server to your MCP configuration file:

"math": {
  "command": "node",
  "args": ["PATH\\TO\\PROJECT\\math-mcp\\build\\index.js"]
}

Here is an example for OpenCode

{
  "mcp": {
    "math-mcp": {
      "type": "local",
      "command": [
        "node",
        "PATH\\TO\\PROJECT\\math-mcp\\build\\index.js"
      ]
    }
  }
}

Replace PATH\\TO\\PROJECT with the actual path to where you cloned the repository.

Note: This project comes prebuilt, so installation is easy but if you change anything in the code, rebuild the project with npm run build.

Available Functions

The Math-MCP server provides the following mathematical operations:

Arithmetic Operations

Function	Description	Parameters
add	Adds two numbers together	firstNumber: The first addend secondNumber: The second addend
subtract	Subtracts the second number from the first number	minuend: The number to subtract from (minuend) subtrahend: The number being subtracted (subtrahend)
multiply	Multiplies two numbers together	firstNumber: The first number secondNumber: The second number
division	Divides the first number by the second number	numerator: The number being divided (numerator) denominator: The number to divide by (denominator)
sum	Adds any number of numbers together	numbers: Array of numbers to sum
modulo	Divides two numbers and returns the remainder	numerator: The number being divided (numerator) denominator: The number to divide by (denominator)
floor	Rounds a number down to the nearest integer	number: The number to round down
ceiling	Rounds a number up to the nearest integer	number: The number to round up
round	Rounds a number to the nearest integer	number: The number to round

Statistical Operations

Function	Description	Parameters
mean	Calculates the arithmetic mean of a list of numbers	numbers: Array of numbers to find the mean of
median	Calculates the median of a list of numbers	numbers: Array of numbers to find the median of
mode	Finds the most common number in a list of numbers	numbers: Array of numbers to find the mode of
min	Finds the minimum value from a list of numbers	numbers: Array of numbers to find the minimum of
max	Finds the maximum value from a list of numbers	numbers: Array of numbers to find the maximum of

Trigonometric Operations

Function	Description	Parameters
sin	Calculates the sine of a number in radians	number: The number in radians to find the sine of
arcsin	Calculates the arcsine (in radians) of a number	number: The number to find the arcsine of
cos	Calculates the cosine of a number in radians	number: The number in radians to find the cosine of
arccos	Calculates the arccosine (in radians) of a number	number: The number to find the arccosine of
tan	Calculates the tangent of a number in radians	number: The number in radians to find the tangent of
arctan	Calculates the arctangent (in radians) of a number	number: The number to find the arctangent of
radiansToDegrees	Converts a radian value to its equivalent in degrees	number: The number in radians to convert to degrees
degreesToRadians	Converts a degree value to its equivalent in radians	number: The number in degrees to convert to radians