Vibe Math

A local/remote high-performance Model Context Protocol (MCP) server for math-ing whilst vibing with LLMs. Built with Polars, Pandas, NumPy, SciPy, and SymPy for optimal calculation speed and comprehensive mathematical capabilities from basic arithmetic to advanced calculus and linear algebra ## Local Installation ### IDEs [](vscode:mcp/install?%7B%22name%22%3A%22Math%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22vibe-math-mcp%22%5D%7D) [](https://cursor.com/en-US/install-mcp?name=Math&config=eyJjb21tYW5kIjoidXZ4IHZpYmUtbWF0aC1tY3AifQ%3D%3D) ### Claude Desktop Open **Settings > Developer > Edit Config** and add: **For published package:** ```json { "mcpServers": { "Math": { "command": "uvx", "args": ["vibe-math-mcp"] } } } ``` ### Claude Code **Quick setup (CLI):** Published package: ```bash claude mcp add --transport stdio math -- uvx vibe-math-mcp ``` **Team setup** (create `mcp.json` in project root for shared use with Claude Code and/or IDEs) ```json { "mcpServers": { "math": { "command": "uvx", "args": ["vibe-math-mcp"] } } } ``` **Verify:** Run `claude mcp list` or use `/mcp` or view available servers in IDEs. ### Try it - "Calculate 15% of 250" → uses `percentage` - "Find determinant of [[1,2],[3,4]]" → uses `matrix_operations` - "Integrate x^2 from 0 to 1" → uses `integral` - "If I invest $1000 at 5% annual interest compounded monthly for 10 years, what will be the future value?" → uses `compound_interest` - If I was paid the square root of $69m in 10 years, what's the present value at 7% discount rate? → uses `batch_execute (calculate -> financial_calcs)` ## Output Control All tools automatically support output control for maximum flexibility and token efficiency. The LLM can specify the desired verbosity. Control response verbosity using the `output_mode` parameter (available on **every tool**): | Mode | Description | Token Savings | Use Case | | --------- | -------------------------------------------------- | ------------- | ------------------------------------------- | | `full` | Complete response with all metadata (default) | 0% (baseline) | Debugging, full context needed | | `compact` | Remove null fields, minimize whitespace | ~20-30% | Moderate reduction, preserve structure | | `minimal` | Primary value(s) only, strip metadata | ~60-70% | Fast extraction, minimal context | | `value` | Normalized `{value: X}` structure | ~70-80% | Consistent chaining, maximum simplicity | | `final` | For sequential chains, return only terminal result | ~95% | Simple calculations, predictable extraction | ## Batch Execution For multi-step workflows, `batch_execute` chains multiple calculations in a single request—**achieving 90-95% token reduction**. Reference prior outputs using `$operation_id.result` syntax, and the engine automatically handles dependency resolution and parallel execution for speed. **Perfect for:** Bond pricing, financial models, statistical pipelines, complex transformations ## Complete Tool Reference **Note:** All tool parameters include detailed descriptions with concrete examples directly in the MCP interface. Each parameter shows expected format, use cases, and sample values to make usage obvious without referring to external documentation. ### Basic Calculations | Tool | Description | | --------------- | ------------------------------------------------------------ | | `calculate` | Evaluate mathematical expressions with variable substitution | | `percentage` | Percentage calculations (of, increase, decrease, change) | | `round` | Advanced rounding (round, floor, ceil, trunc) | | `convert_units` | Unit conversions (degrees � radians) | ### Array Operations | Tool | Description | | ------------------ | ---------------------------------------------------------------- | | `array_operations` | Element-wise operations (add, subtract, multiply, divide, power) | | `array_statistics` | Statistical measures (mean, median, std, min, max, sum) | | `array_aggregate` | Aggregations (sumproduct, weighted average, dot product) | | `array_transform` | Transformations (normalise, standardise, scale, log) | ### Statistics | Tool | Description | | ------------- | ------------------------------------------------------ | | `statistics` | Comprehensive analysis (describe, quartiles, outliers) | | `pivot_table` | Create pivot tables with aggregation | | `correlation` | Correlation matrices (Pearson, Spearman) | ### Financial Mathematics | Tool | Description | | ------------------- | ------------------------------------------- | | `financial_calcs` | Time value of money (PV, FV, PMT, IRR, NPV) | | `compound_interest` | Compound interest with various frequencies | ### Linear Algebra | Tool | Description | | ---------------------- | -------------------------------------------------------------------- | | `matrix_operations` | Matrix operations (multiply, inverse, transpose, determinant, trace) | | `solve_linear_system` | Solve Ax = b systems | | `matrix_decomposition` | Decompositions (eigen, SVD, QR, Cholesky, LU) | ### Calculus | Tool | Description | | --------------- | -------------------------------------- | | `derivative` | Symbolic and numerical differentiation | | `integral` | Symbolic and numerical integration | | `limits_series` | Limits and series expansions |