🧮 Math & Calculator MCP Server

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.

📖 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.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. 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!