📐 MathServer – MCP Project

MathServer is a simple Model Context Protocol (MCP) server built in Python that provides math operations (addition, subtraction, multiplication, division, etc.) through an API.
It is designed to be connected with MCP-compatible clients like chatbots or automation tools.

This project demonstrates how to create a custom MCP server for handling computations.

🌟 Features

✅ Supports basic math operations: addition, subtraction, multiplication, division

✅ Written in pure Python

✅ Easy to extend with new math functions (power, square root, modulo, etc.)

✅ Works as a local MCP server that clients can connect to

✅ Clean project structure with virtual environment setup

📂 Project Structure
mathserver/
├── server.py          # Main MCP math server (math logic lives here)
├── requirements.txt   # Dependencies (install with pip)
├── README.md          # Documentation
└── .gitignore         # Ignore .env, venv, cache files


server.py → contains the Python code for math operations

requirements.txt → contains libraries to install before running

.gitignore → ignores virtual environments and secret files

🛠️ Installation
1. Clone the repository
git clone https://github.com/your-username/mathserver.git
cd mathserver

2. Create a virtual environment
python -m venv .venv

3. Activate the virtual environment

Windows (Command Prompt):

.venv\Scripts\activate


Windows (PowerShell):

.venv\Scripts\Activate.ps1


Linux/Mac:

source .venv/bin/activate

4. Install dependencies
pip install -r requirements.txt

▶️ Usage

Run the math server with:

python server.py


Once running, clients can send math requests.

Example Request
{
  "operation": "add",
  "numbers": [5, 10]
}

Example Response
{
  "result": 15
}

Other Supported Operations

sub → subtraction

mul → multiplication

div → division (handles divide-by-zero safely)

🧩 Extending the Server

You can easily add more operations inside server.py.
For example, to add power (^):

def power(a, b):
    return a ** b


Then update your request handler to support "operation": "power".

🤝 Contributing

Contributions are welcome! 🚀
If you’d like to add new math operations, improve the server, or fix bugs:

Fork the repo

Create a feature branch (git checkout -b feature-new-operation)

Commit your changes (git commit -m "Add power operation")

Push to the branch (git push origin feature-new-operation)

Open a Pull Request