MCP-Server-V3
If you are the rightful owner of MCP-Server-V3 and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A lightweight AI-powered Chrome Extension connected to a Flask-based MCP Server, enabling users to perform complex BODMAS operations directly from the browser.
MCP Server AI Chrome Extension
A lightweight AI-powered Chrome Extension connected to a Flask-based MCP Server, enabling users to perform complex BODMAS (Bracket, Order, Division, Multiplication, Addition, Subtraction) operations directly from the browser.
โจ Features
- ๐ Solve complex mathematical expressions with full BODMAS hierarchy.
- โก Instant real-time computation via a backend AI MCP server.
- ๐ง Server processes user input with decision-making and memory modules.
- ๐ Simple and clean Chrome Extension interface.
- ๐ Easy communication between Chrome Extension and Flask API server.
๐๏ธ Project Structure
MCP-Server-V3/
โ
โโโ flask-api/
โ โโโ action.py # Handles mathematical operations
โ โโโ decision.py # Decides actions based on parsed user input
โ โโโ memory.py # Maintains session memory and history
โ โโโ mcp_server.py # Main Flask server running the API
โ โโโ mcp_client.py # Client utilities (if needed)
โ โโโ models.py # Defines data models for input/output
โ โโโ perception.py # Parses and understands user queries
โ โโโ requirements.txt # Python dependencies
โ
โโโ chrome-extension/
โ โโโ manifest.json # Chrome extension manifest
โ โโโ popup.html # Extension popup frontend
โ โโโ popup.js # JS logic to interact with backend server
โ
โโโ requirements.txt # Top-level requirements
โ
โโโ README.md # ๐ (You are here!)
๐ How It Works
-
User Interaction:
- User opens the Chrome Extension popup.
- Enters a math expression (e.g.,
5 * (3 + 2) - 4 / 2).
-
Chrome Extension (Frontend):
- Captures the user input.
- Sends a
POSTrequest to the Flask MCP Server API.
-
Flask API (Backend Server):
- Parses the input via
perception.py. - Uses
decision.pyandaction.pyto compute the correct BODMAS result. - Returns the final output back to the Chrome Extension.
- Parses the input via
-
Result Display:
- Extension receives the response.
- Displays the computed answer to the user in the popup.
๐ ๏ธ Installation Guide
1. Set Up the MCP Server
# Clone the repo
git clone https://github.com/shettysaish20/MCP-Server-V3.git
cd MCP-Server-V3/flask-api
# Install Python dependencies
pip install -r requirements.txt
# Run the server
python mcp_client.py
By default, server runs at: http://localhost:5000/
2. Set Up the Chrome Extension
- Open
chrome://extensions/in Chrome. - Enable Developer Mode.
- Click Load unpacked and select the
chrome-extension/folder. - Extension will appear in the browser toolbar.
3. Usage
- Click on the MCP extension icon.
- Type a BODMAS-based math query.
- View instant computed results!
๐ฆ Dependencies
-
Backend (Python):
- Flask
- Flask-Cors
(All backend libraries are listed in
requirements.txt.) -
Frontend (Extension):
- Pure JavaScript + HTML/CSS (no external libraries).
๐ Running
๐ License
MIT License.
Feel free to modify, extend, and enhance as you wish!
๐จโ๐ป Author
Built with โค๏ธ by Saish Shetty
