io.github.rog0x/math
Calculator, units, statistics for AI agents
Open source Open in the app JSON README (API)
About
Calculator, units, statistics for AI agents
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- rog0x
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Last push
- 2026-03-21T20:21:44Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-08-29 04:01:19
- Updated
- 2026-08-29 04:01:19
- Origin id
io.github.rog0x/math
README
# mcp-math-tools
Math and calculation tools for AI agents, exposed via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io).
## Tools
### `calculate`
Evaluate math expressions safely (no `eval`). Supports arithmetic operators (`+`, `-`, `*`, `/`, `^`, `%`), parentheses, functions (`sqrt`, `abs`, `floor`, `ceil`, `round`, `log`, `ln`, `sin`, `cos`, `tan`, `min`, `max`, `pow`), constants (`pi`, `e`), and named variables.
### `convert_units`
Convert between units across six categories:
- **Length**: m, km, cm, mm, mi, yd, ft, in
- **Weight**: kg, g, mg, lb, oz, ton
- **Temperature**: C, F, K
- **Data**: B, KB, MB, GB, TB
- **Time**: s, min, h, d, week
- **Speed**: m/s, km/h, mph, knots
### `statistics`
Statistical analysis on datasets: mean, median, mode, variance, standard deviation, min, max, range, percentile, correlation between two arrays, and a full summary mode.
### `format_number`
Format numbers as: currency (`$1,234.56`), percentage, scientific notation, binary, octal, hexadecimal, significant figures, or with thousands separators.
### `percentage_calc`
Common percentage operations: X% of Y, what percent X is of Y, percentage change between two values, tip calculator, discount calculator, and markup calculator.
## Installation
```bash
npm install
npm run build
```
## Usage with Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"math-tools": {
"command": "node",
"args": ["path/to/mcp-math-tools/dist/index.js"]
}
}
}
```
## Examples
**Calculate**: `2 * (3 + 4) ^ 2` returns `98`
**Convert**: `100` from `km/h` to `mph` returns `62.137...`
**Statistics**: summary of `[1, 2, 3, 4, 5]` returns mean, median, mode, variance, etc.
**Format**: `1234567.89` as `currency` returns `$1,234,567.89`
**Percentage**: `15%` tip on `85.50` bill split 3 ways
## License
MIT