Mathematical Calculator MCP Server

This is a Model Context Protocol (MCP) server that provides Claude with advanced mathematical calculation capabilities, including symbolic math, statistical analysis, and matrix operations.

Features

The Mathematical Calculator MCP Server provides the following tools:

• Basic Calculations: Evaluate mathematical expressions safely
• Symbolic Mathematics:
  • Solve equations (linear, quadratic, polynomial, etc.)
  • Calculate derivatives of expressions
  • Compute integrals of expressions
• Statistical Analysis:
  • Mean, median, mode
  • Variance, standard deviation
  • Correlation coefficient
  • Linear regression
  • Confidence intervals
• Matrix Operations:
  • Matrix addition
  • Matrix multiplication
  • Matrix transposition

Installation

Prerequisites

• Python 3.10+ (recommended: Python 3.11+)
• uv (recommended) or pip
• Claude Desktop app (to use the MCP server with Claude)

Installation Steps

1. Clone the repository:

   git clone https://github.com/huhabla/calculator-mcp-server.git
   cd calculator-mcp-server
   

2. (Option 1) Setup with the provided script:

   chmod +x setup_venv.sh
   ./setup_venv.sh
   

   (Option 2) Or manually set up the virtual environment:

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

3. Run doc-tests to verify everything works:

   bash run_doctests.sh
   

Integration with Claude Desktop

Method 1: Configure in Claude Desktop

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following to the mcpServers section:

{
  "mcpServers": {
    "calculator": {
      "command": "uvx",
      "args": [
        "--from",
        "calculator-mcp-server@git+https://github.com/huhabla/calculator-mcp-server.git",
        "--",
        "calculator-mcp-server",
        "--stdio"
      ]
    }
  }
}

Note: The --stdio flag is required for proper integration with Claude Desktop. The -- separates uvx arguments from the calculator server arguments.

Method 2: Install with FastMCP

1. Make sure you have uv installed (Installation Guide)

2. Install the MCP server in Claude Desktop:

   fastmcp install calculator_server.py
   

   Or with a custom name:

   fastmcp install calculator_server.py --name "Math Calculator"
   

3. Once installed, Claude will automatically have access to all the mathematical tools and functions.

Usage Examples

After integrating with Claude Desktop, you can ask Claude to perform various mathematical operations. Here are some examples:

Basic Calculations

Can you calculate 3.5^2 * sin(pi/4)?

Solving Equations

Solve the following equation: x^2 - 5x + 6 = 0

Calculating Derivatives

What's the derivative of sin(x^2) with respect to x?

Computing Integrals

Calculate the integral of x^2 * e^x

Statistical Analysis

Find the mean, median, mode, and standard deviation of this dataset: [23, 45, 12, 67, 34, 23, 18, 95, 41, 23]

Linear Regression

Perform a linear regression on these points: (1,2), (2,3.5), (3,5.1), (4,6.5), (5,8.2)

Matrix Operations

Multiply these two matrices:
[1, 2, 3]
[4, 5, 6]

and

[7, 8]
[9, 10]
[11, 12]

Development

Testing

Run the comprehensive doctest suite:

bash run_doctests.sh

Interactive Development Mode

For development and debugging, you can use the FastMCP development mode:

fastmcp dev calculator_server.py

This will start a local web interface where you can test all tools interactively.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• FastMCP for the Pythonic MCP server framework
• SymPy for symbolic mathematics
• NumPy and SciPy for numerical and statistical computations

mcp_calculator