📐 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
