MCP Calculator Server

Provides a simple MCP server for Claude that supports arithmetic operations, including an add tool to compute sums.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rblpaul-coder-mcp_learning": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "-m",
        "mcp_calculatora"
      ]
    }
  }
}

You can run a lightweight MCP server that provides arithmetic calculations for Claude. This MCP server exposes a simple add tool to compute sums, helping you integrate quick mathematical operations into your Claude workflows.

How to use

After configuring the MCP server in Claude, you can call the calculator to perform additions. For example, you can ask Claude to add two numbers, and the server will return the result. This enables seamless, programmatic arithmetic within your conversations.

How to install

Prerequisites you need before installing include Python and a working internet connection to fetch dependencies.

# Clone the repository
git clone https://github.com/yourusername/mcp-calculatorA.git
cd mcp-calculatorA

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# Install dependencies in editable/development mode
pip install -e .

Alternatively, you can install the package from PyPI if you prefer to install a released version directly.

pip install mcp-calculatorA

Additional content

Configuration details show how Claude connects to the MCP server. You specify the server in Claude’s settings so that Claude can invoke the MCP tool when you request calculations.

Claude Code configuration for the MCP server looks like this, pointing to your Python virtual environment and the MCP module.

{
  "mcpServers": {
    "calculatorA": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "mcp_calculatora"]
    }
  }
}

Claude Desktop configuration shows how to reference the local MCP server from desktop clients.

{
  "mcpServers": {
    "calculatorA": {
      "command": "mcp-calculatorA"
    }
  }
}

Notes on usage and structure

Developers can run the server locally using the development command shown in the project structure. This starts the server so you can test calls from Claude or any MCP client.

# Run the server for testing
python -m mcp_calculatora

Project structure

The project is organized to separate the MCP server logic from command-line and packaging details.

mcp-calculatorA/
├── mcp_calculatora/
│   ├── __init__.py
│   └── server.py      # MCP server implementation
├── pyproject.toml       # Project configuration
└── README.md

Development

For development and testing, you can run the server directly to verify behavior before enabling it for Claude.

python -m mcp_calculatora

License

MIT License.

Available tools

add

Calculates the sum of two numbers using the add tool. You pass two numeric parameters, a and b, and receive their total.