# 🧮 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.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)

## 📖 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-](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

```bash
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`

```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):

```json
{
  "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

```bash
# 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:

```bash
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](https://github.com/Ankluna72)
- Repository: [Math-Calculator-MCP-Server-](https://github.com/Ankluna72/Math-Calculator-MCP-Server-)

## 🌟 Acknowledgments

- Built with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/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!