Calculator

What is mcp-server-calculator?

mcp-server-calculator is a Model Context Protocol (MCP) server that provides calculator functionality to Large Language Models (LLMs). It allows LLMs to perform precise numerical calculations by integrating with this server.

How to use mcp-server-calculator?

Installation:

• Using uv (recommended): No specific installation is needed. You can directly run it using uvx after installing uv.

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

• Using PIP: Install via pip: pip install mcp-server-calculator. After installation, run as a script: python -m mcp_server_calculator.

Configuration: Add the following to your MCP client settings:

• Using uv:

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

• Using PIP:

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

Key Features of mcp-server-calculator

• Precise Numerical Calculations: Enables LLMs to perform accurate mathematical operations.
• Model Context Protocol (MCP) Integration: Designed to seamlessly integrate with MCP-compatible LLM clients.
• calculate Tool: Provides a single, clear tool for evaluating expressions.
  • expression (string, required): The mathematical expression to be calculated.
• Flexible Installation: Supports installation via uv (recommended) or pip.

Use Cases of mcp-server-calculator

• Enhancing LLM Capabilities: Allows LLMs to answer complex mathematical questions or perform calculations within their responses.
• Data Analysis and Reporting: LLMs can use this server to process numerical data and generate reports with accurate calculations.
• Educational Tools: Can be integrated into educational platforms where LLMs assist users with mathematical problems.

FAQ about mcp-server-calculator

• Q: What is the purpose of mcp-server-calculator? A: It allows Large Language Models (LLMs) to perform precise numerical calculations by acting as a Model Context Protocol (MCP) server.
• Q: How do I install mcp-server-calculator? A: You can install it using uv (recommended, no specific installation needed, just run with uvx) or pip (pip install mcp-server-calculator).
• Q: What kind of calculations can it perform? A: It can evaluate any given mathematical expression provided to its calculate tool.
• Q: What is the license for mcp-server-calculator? A: It is licensed under the MIT License, allowing for free use, modification, and distribution.

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 no specific installation is needed. We will use uvx to directly run mcp-server-calculator.

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

Using PIP

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

pip install mcp-server-calculator

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

python -m mcp_server_calculator

Configuration

Using uv (recommended)

Add this to your MCP client settings:

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

Using PIP

Alternatively add this to your MCP client settings:

"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.