avisangle/calculator-server

A comprehensive **Go-based MCP (Model Context Protocol) server** for mathematical computations, implementing **13 mathematical tools** with advanced features and high precision calculations.
**Owner & Maintainer:** Avinash Sangle (avinash.sangle123@gmail.com)
🧮 Features
Core Mathematical Tools (13 Tools)
Basic Mathematical Tools (6 Tools)
1. **Basic Math Operations** - Precision arithmetic with configurable decimal places
- Addition, subtraction, multiplication, division
- Multiple operand support
- Decimal precision control (0-15 places)
2. **Advanced Mathematical Functions** - Scientific calculations
- Trigonometric: sin, cos, tan, asin, acos, atan
- Logarithmic: log, log10, ln
- Other: sqrt, abs, factorial, exp, pow
- Unit support: degrees/radians for trig functions
- Power function with base and exponent parameters
3. **Expression Evaluation** - Complex mathematical expressions
- Variable substitution support
- Mathematical constants (π, e)
- Nested expressions with parentheses
- Function calls within expressions
4. **Statistical Analysis** - Comprehensive data analysis
- Descriptive statistics: mean, median, mode
- Variability: standard deviation, variance
- Percentile calculations
- Data validation and error handling
5. **Unit Conversion** - Multi-category unit conversion
- **Length**: mm, cm, m, km, in, ft, yd, mi, mil, μm, nm
- **Weight**: mg, g, kg, t, oz, lb, st (stone), ton (US ton)
- **Temperature**: °C, °F, K, R (Rankine)
- **Volume**: ml, cl, dl, l, kl, fl_oz, cup, pt, qt, gal, tsp, tbsp, bbl
- **Area**: mm², cm², m², km², in², ft², yd², mi², acre, ha
6. **Financial Calculations** - Comprehensive financial modeling
- Interest calculations: simple & compound
- Loan payment calculations
- Return on Investment (ROI)
- Present/Future value calculations
- Net Present Value (NPV) & Internal Rate of Return (IRR)
Advanced Specialized Tools (7 Tools)
7. **Statistics Summary** - Comprehensive statistical summary of datasets
- Complete statistical overview including all measures
- Data preview with first/last elements
- Common percentiles (25th, 50th, 75th)
8. **Percentile Calculation** - Calculate specific percentiles (0-100)
- Any percentile value between 0 and 100
- Data count and preview information
- Accurate percentile calculations using empirical method
9. **Batch Unit Conversion** - Convert multiple values between units at once
- Bulk conversion operations
- Same unit categories as single conversion
- Efficient batch processing
10. **Net Present Value (NPV)** - Advanced NPV calculations with cash flows
- Multiple cash flow periods
- Discount rate calculations
- Investment decision support
11. **Internal Rate of Return (IRR)** - IRR calculations for investment analysis
- Cash flow analysis
- Newton-Raphson method for accurate IRR calculation
- Investment performance evaluation
12. **Loan Comparison** - Compare multiple loan scenarios
- Multiple loan option analysis
- Payment calculations for each scenario
- Comparison metrics and recommendations
13. **Investment Scenarios** - Compare multiple investment scenarios
- Multiple investment option analysis
- Future value calculations for each scenario
- Investment comparison and recommendations
Technical Features
- **High Precision**: Uses shopspring/decimal for financial calculations
- **Scientific Computing**: Powered by gonum.org/v1/gonum
- **Expression Engine**: Advanced parsing with govaluate
- **Comprehensive Testing**: >95% test coverage
- **Error Handling**: Detailed error messages and validation
- **MCP Protocol**: Full compliance with MCP specification
- **Build Automation**: Complete Makefile with CI/CD support
- **Streamable HTTP Transport**: MCP-compliant HTTP transport with SSE support
🚀 Quick Start
Prerequisites
- **Go 1.21+** (required)
- **Git** (for version control)
Installation
Alternative Setup
📊 Usage Examples
Basic Mathematics
**Response:**
Advanced Mathematical Functions
Statistics Summary
Percentile Calculation
Net Present Value
Batch Unit Conversion
🌐 MCP Streamable HTTP Transport
The server implements **MCP-compliant streamable HTTP transport** according to the official MCP specification, providing real-time communication with Server-Sent Events (SSE) streaming support.