Calculator Mcp Server

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:

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

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

``bash chmod +x setup_venv.sh ./setup_venv.sh ``

(Option 2) Or manually set up the virtual environment: ``bash python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ``

1. Run doc-tests to verify everything works:

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

1. Install the MCP server in Claude Desktop:

``bash fastmcp install calculator_server.py ``

Or with a custom name: ``bash fastmcp install calculator_server.py --name "Math Calculator" ``

1. 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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: huhabla
• Source: huhabla/calculator-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.