number-range-stats MCP Server

Calculates statistics (sum, mean, median, mode, min, max, and standard deviation) for a list of numbers or a numerical range. Provides an easy-to-use MCP tool for Claude Desktop or any MCP-compliant client.

Installation

Using npx (recommended)

npx @dennisk2025/number-range-stats

Or install globally

npm install -g @dennisk2025/number-range-stats

Adding to Claude Desktop

Add the following to your Claude Desktop config file:

claude_desktop_config.json

{
  "mcpServers": {
    "numberrangestats": {
      "command": "npx",
      "args": ["@dennisk2025/number-range-stats"]
    }
  }
}

Add this to your Claude Desktop config file at:

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

Usage

Once running, the following tool is available:

Tool: calculate_stats

Calculates statistics for a list of numbers or a numerical range.

Parameters:

• numbers (array of numbers, optional): A list of numbers to analyze.
• range_start (number, optional): Optional range start (inclusive). Use with range_end to generate a range.
• range_end (number, optional): Optional range end (inclusive). Use with range_start to generate a range.
• range_step (number, optional): Step for generated range (default: 1).

Either provide numbers, or both range_start and range_end.

Example Calls

1. List of Numbers

{
  "name": "calculate_stats",
  "arguments": {
    "numbers": [5, 2, 8, 2, 3]
  }
}

2. Range (1 to 5)

{
  "name": "calculate_stats",
  "arguments": {
    "range_start": 1,
    "range_end": 5
  }
}

3. Range with Step

{
  "name": "calculate_stats",
  "arguments": {
    "range_start": 10,
    "range_end": 20,
    "range_step": 2
  }
}

Response Example

{
  "count": 5,
  "sum": 20,
  "mean": 4,
  "median": 3,
  "mode": 2,
  "min": 2,
  "max": 8,
  "standard_deviation": 2.280350850198276
}

• If multimodal, mode will return an array of numbers.

Available Tools

calculate_stats

• Description: Given a list or range of numbers, returns the sum, mean, median, mode, minimum, maximum, and standard deviation.
• Parameters:
  • numbers (array of numbers, optional): List of numbers
  • range_start (number, optional): Inclusive range start
  • range_end (number, optional): Inclusive range end
  • range_step (number, optional): Step size for range (1 by default)

At least one input method is required: supply a non-empty numbers array or both range_start and range_end.