Content
# 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](https://github.com/astral-sh/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
```
2. (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
```
3. 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:
```json
{
"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](https://github.com/astral-sh/uv))
2. 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"
```
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
bash run_doctests.sh
```
### Interactive Development Mode
For development and debugging, you can use the FastMCP development mode:
```bash
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](https://github.com/jlowin/fastmcp) for the Pythonic MCP server framework
- [SymPy](https://sympy.org/) for symbolic mathematics
- [NumPy](https://numpy.org/) and [SciPy](https://scipy.org/) for numerical and statistical computations
Connection Info
You Might Also Like
everything-claude-code
Complete Claude Code configuration collection - agents, skills, hooks,...
markitdown
Python tool for converting files and office documents to Markdown.
awesome-claude-skills
A curated list of awesome Claude Skills, resources, and tools for...
antigravity-awesome-skills
The Ultimate Collection of 130+ Agentic Skills for Claude...
context-mode
MCP is the protocol for tool access. We're the virtualization layer for context.
claude-context-mode
claude-context-mode plugin reduces MCP context bloat, saving up to 99% of tokens.