BatoolRubab/MCP-Calculator-Server

MCP-Calculator-Server

A minimal, production-ready Model Context Protocol (MCP) server that exposes a collection of math utilities (arithmetic, trigonometry, algebra, number theory) via the Python MCP SDK’s FastMCP (mcp.server.fastmcp.FastMCP).

✨ Features

• Simple, readable implementation using FastMCP
• 16+ tools covering common calculator operations
• Safe input validation with helpful error messages
• Works with MCP Inspector, Claude Desktop, and any MCP-compatible client
• Transport: stdio

🧰 Available Tools

The following tools are available for AI agents to call:

• add(a: int, b: int) -> int — Add two numbers.
• sub(a: int, b: int) -> int — Subtract two numbers.
• mul(a: int, b: int) -> int — Multiply two numbers.
• div(a: int, b: int) -> float — Divide two numbers (floating point result).
• power(base: float, exponent: float) -> float — Raise a number to a power.
• square_root(x: float) -> float — Square root of a number.
• factorial(n: int) -> int — Factorial of a non-negative integer.
• log(x: float, base: float = math.e) -> float — Logarithm with optional base.
• sin(x: float) -> float — Sine of an angle (radians).
• cos(x: float) -> float — Cosine of an angle (radians).
• tan(x: float) -> float — Tangent of an angle (radians).
• degrees_to_radians(degrees: float) -> float — Convert degrees to radians.
• radians_to_degrees(radians: float) -> float — Convert radians to degrees.
• gcd(a: int, b: int) -> int — Greatest common divisor.
• lcm(a: int, b: int) -> int — Least common multiple.
• is_prime(n: int) -> bool — Check if a number is prime.
• quadratic_roots(a: float, b: float, c: float) -> tuple — Solve ax² + bx + c = 0.

⚠️ Error Handling

• Division by zero → raises ValueError.
• Square root of negative numbers → raises ValueError.
• Factorial of negative numbers → raises ValueError.
• Logarithms with invalid inputs (non-positive numbers or invalid bases) → raises ValueError.

🔧 Extending the Server

Add new tools by decorating functions with @mcp.tool() and using clear type hints + docstrings. Example:

@mcp.tool()
def nth_fibonacci(n: int) -> int:
    """Return the nth Fibonacci number (n >= 0)"""
    if n < 0:
        raise ValueError("n must be non-negative")
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a

Restart the server to expose new tools.

Made with ❤️ by Rubab Batool