MCP Calculator Demo

by pijush2022

172 downloads

Not rated

GitHub

Other

Description

# MCP Calculator Demo A demonstration project showcasing a calculator service using the MCP (Model Control Protocol) framework. This project consists of a server that provides basic arithmetic operations and a client that can evaluate both simple and complex mathematical…

About

Details

Author: pijush2022
Downloads: 172
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name MCP Calculator Demo

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

From the repository

Clone the repository, create a virtual environment with Python 3.7+, install dependencies from requirements.txt, then start the server with python calculator_server.py (defaults to http://127.0.0.1:5005). In a separate terminal, run python client.py to interact using commands like add 2 3 or complex expressions such as (5+7)*2.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp calculator demo": {
            "MCP-server-with-client-demo-for-calculator-with-SSE-": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

McpServers

{
    "MCP-server-with-client-demo-for-calculator-with-SSE-": {
        "command": "python",
        "args": [
            "-m",
            "venv",
            ".venv"
        ]
    }
}

MCP Calculator Demo

A demonstration project showcasing a calculator service using the MCP (Model Control Protocol) framework. This project consists of a server that provides basic arithmetic operations and a client that can evaluate both simple and complex mathematical expressions.

Project Structure

- calculator_server.py: The MCP server that provides arithmetic operations - client.py: The client application that connects to the server and processes user input - requirements.txt: Project dependencies

Features

- Basic arithmetic operations (addition, subtraction, multiplication, division) - Support for both simple operations (e.g., "add 2 3") and complex expressions - Error handling for division by zero - Server-Sent Events (SSE) communication between client and server - Support for parentheses in expressions - RPN (Reverse Polish Notation) evaluation for complex expressions

Prerequisites

- Python 3.7+ - pip (Python package manager)

Installation

1. Clone the repository 2. Create and activate a virtual environment: ``

bash
   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate


3. Install dependencies:

bash
   pip install -r requirements.txt



Usage


Starting the Server


Run the calculator server:

bash
python calculator_server.py



The server will start on

http://127.0.0.1:5005

 by default.

Running the Client


In a separate terminal, run the client:

bash
python client.py



Available Operations


The calculator supports the following operations:

1. Direct tool syntax:
   -

add 2 3

subtract 5 2

multiply 4 3

divide 10 2



2. Complex expressions:
   -

5+7-2

5+7-23-(5+7)2

10/2+34Example Usage`» add 2 3 Result: 5 » 5+7-2

3
Result: 6

» (5+7)*2
Result: 24

» divide 10 0
Error: Division by zero.

Technical Details

- The server uses FastMCP for handling MCP operations - Communication between client and server is done via Server-Sent Events (SSE) - The client implements the Shunting-Yard algorithm for parsing complex expressions - Error handling is implemented for invalid expressions and division by zero

Dependencies

- fastapi - uvicorn - sse-starlette - fastmcp>=0.1.0 - llama-index - llama-index-llms-anthropic - anthropic - python-dotenv - requests - sseclient-py - uv

License

This project is open source and available under the MIT License.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

MCP Calculator Demo

Project Structure

Features

Prerequisites

Installation

Usage

Starting the Server

Running the Client

Available Operations

Example Usage

Technical Details

Dependencies

License

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀