mcp-calculator-server

yinebebt/mcp-calculator-server

3.1

If you are the rightful owner of mcp-calculator-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The MCP Calculator Server is a Model Context Protocol server that provides calculator functionality for MCP clients.

MCP Calculator Server

A Model Context Protocol (MCP) server that provides calculator functionality with robust mathematical operations.

Features

Tools

  • calculate: Mathematical operations with proper operator precedence, parentheses support, and scientific notation
  • random_number: Generate random numbers within specified ranges using various probability distributions(elicitation).

Resources

  • math://constants: Mathematical constants (π, e, φ, √2, ln2, ln10) in JSON format
  • server://info: Server information and capabilities overview

Prompts

  • math_problem: Generate mathematical word problems with configurable difficulty and topics
  • explain_calculation: Step-by-step mathematical expression explanations

Transport Modes

  • stdio: For local development and MCP Inspector integration
  • streamable-http: For web deployments and container environments

Default Behavior:

  • Transport: streamable-http (if no TRANSPORT environment variable is set)
  • Port: 8080 (configurable via PORT environment variable)

Usage

# Install
go install github.com/yinebebt/mcp-calculator-server@latest

# Run with stdio
TRANSPORT=stdio mcp-calculator-server

# Run with HTTP
mcp-calculator-server

# Test
go test

MCP Client Configuration

For testing with MCP Client:

{
  "command": "/path/to/mcp-calculator-server",
  "env": {
    "TRANSPORT": "stdio"
  }
}

Mathematical Features

  • Operator precedence: 2+3*4 = 14
  • Parentheses: (2+3)*4 = 20
  • Scientific notation: 1e2 = 100
  • Error detection: Division by zero, invalid syntax, unmatched parentheses