📐 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
-
Clone the repository git clone https://github.com/your-username/mathserver.git cd mathserver
-
Create a virtual environment python -m venv .venv
-
Activate the virtual environment
Windows (Command Prompt):
.venv\Scripts\activate
Windows (PowerShell):
.venv\Scripts\Activate.ps1
Linux/Mac:
source .venv/bin/activate
- 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