🧮 Math & Calculator MCP Server

Name: Math & Calculator MCP Server
Author: Ankluna72

A powerful Model Context Protocol (MCP) Server that provides advanced mathematical utilities and calculator tools for AI assistants like Claude and other MCP-compatible clients.

$License: MIT$ $Node.js Version$ $TypeScript$

📖 About

This MCP server exposes mathematical tools that AI assistants can use to perform calculations, statistical analysis, unit conversions, and more. Built with the Model Context Protocol SDK, it seamlessly integrates with Claude Desktop, VSCode, and other MCP clients.

Author: Jefferson Rosas Chambilla
Repository: https://github.com/Ankluna72/Math-Calculator-MCP-Server-

✨ Features

🔢 Basic Calculator

Addition, subtraction, multiplication, division
Power, square root, modulo operations
Error handling (division by zero, invalid operations)

📊 Statistical Analysis

Mean, median, mode
Standard deviation and variance
Complete statistical summaries

🔄 Unit Conversions

Length: meters, kilometers, miles, feet, inches
Weight: kilograms, grams, pounds, ounces
Temperature: Celsius, Fahrenheit, Kelvin

📐 Equation Solver

Quadratic equation solver (ax² + bx + c = 0)
Handles real and complex solutions
Discriminant analysis

💯 Percentage Calculator

Percentage of a number
Percentage increase/decrease
"What percentage is X of Y?"

📏 Trigonometry

Sin, cos, tan (and inverse functions)
Angle calculations in degrees
Precise floating-point results

🚀 Installation

Prerequisites

Node.js >= 18.0.0
npm or yarn

Clone and Install

git clone https://github.com/Ankluna72/Math-Calculator-MCP-Server-.git cd Math-Calculator-MCP-Server- npm install npm run build

⚙️ Configuration

For Claude Desktop

Add to your Claude Desktop config file (claude_desktop_config.json):

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{ "mcpServers": { "math-calculator": { "command": "node", "args": [ "C:\\path\\to\\Math-Calculator-MCP-Server-\\dist\\index.js" ] } } }

For VSCode with Cline Extension

Add to VSCode settings (.vscode/settings.json or User Settings):

{ "mcp.servers": { "math-calculator": { "command": "node", "args": [ "C:\\path\\to\\Math-Calculator-MCP-Server-\\dist\\index.js" ] } } }

📚 Usage Examples

Once configured, your AI assistant can use these tools automatically. Here are some example requests:

Basic Calculations

"Calculate 25 * 4" "What is the square root of 144?" "Divide 100 by 7"

Statistics

"Calculate the mean of [10, 20, 30, 40, 50]" "Find median and mode for these numbers: [5, 3, 5, 2, 8, 5]" "Give me all statistics for [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]"

Unit Conversions

"Convert 100 kilometers to miles" "How many pounds is 75 kilograms?" "Convert 32 Fahrenheit to Celsius"

Solve Equations

"Solve x² - 5x + 6 = 0" "Find solutions for 2x² + 3x - 2 = 0"

Percentages

"What is 15% of 200?" "Increase 50 by 20%" "What percentage is 25 of 200?"

Trigonometry

"Calculate sin(30°)" "What is cos(45°)?" "Find tan(60°)"

🛠️ Available Tools

Tool	Description
`calculate`	Basic arithmetic operations
`statistics`	Statistical analysis of number arrays
`convert_units`	Convert between different units
`solve_equation`	Solve quadratic equations
`percentage`	Percentage calculations
`trigonometry`	Trigonometric functions

📁 Project Structure

Math-Calculator-MCP-Server-/ ├── src/ │ └── index.ts # Main MCP server implementation ├── dist/ # Compiled JavaScript (after build) ├── package.json # Project dependencies ├── tsconfig.json # TypeScript configuration ├── .gitignore └── README.md

🔧 Development

# Install dependencies npm install # Build the project npm run build # Development mode (watch for changes) npm run dev # Start the server npm start

🧪 Testing

You can test the server manually using stdio communication:

npm start

Then send MCP protocol messages via stdin to test tool execution.

📝 License

MIT License - see LICENSE file for details

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📧 Contact

Jefferson Rosas Chambilla

GitHub: @Ankluna72
Repository: Math-Calculator-MCP-Server-

🌟 Acknowledgments

Built with the Model Context Protocol SDK
Inspired by the need for mathematical tools in AI assistants
Thanks to Anthropic for developing the MCP standard

⭐ If you find this project useful, please consider giving it a star on GitHub!

This server cannot be installed

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Math & Calculator MCP Server