Skip to main content
Glama
githejie

Calculator MCP Server

by githejie
README.md
# Calculator MCP Server

A Model Context Protocol server for calculating. This server enables LLMs to use calculator for precise numerical calculations.

### Available Tools

- `calculate` - Calculates/evaluates the given expression.
  - `expression` (string, required): Expression to be calculated

## Installation

### Using uv (recommended)

When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-calculator*.

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### Using PIP

Alternatively you can install `mcp-server-calculator` via pip:

```bash
pip install mcp-server-calculator
```

After installation, you can run it as a script using:

```bash
python -m mcp_server_calculator
```

## Configuration

### Using uv (recommended)

Add this to your MCP client settings:

```json
"mcpServers": {
  "calculator": {
    "command": "uvx",
    "args": ["mcp-server-calculator"]
  }
}
```

### Using PIP

Alternatively add this to your MCP client settings:

```json
"mcpServers": {
  "calculator": {
    "command": "python",
    "args": ["-m", "mcp_server_calculator"]
  }
}
```

## License

mcp-server-calculator is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

TDQS

C2.3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools; the single tool 'calculate' has a distinct and clear purpose for evaluating expressions.

Naming Consistency5/5

The single tool name 'calculate' follows a consistent verb-based pattern, and with only one tool, there is no inconsistency in naming conventions to evaluate.

Tool Count2/5

A single tool for a calculator server feels thin and under-scoped, as it lacks operations for common mathematical functions (e.g., add, subtract, trigonometric functions) or advanced features, making it borderline too few for the domain.

Completeness2/5

The tool surface is severely incomplete for a calculator domain; it only provides a generic 'calculate' tool without covering basic arithmetic operations, scientific functions, or memory features, leading to significant gaps in functionality.

Maintenance

ActivitySlowing
ResponsivenessResponsive