Universal MCP Server Framework
An open-source, modular MCP (Model Context Protocol) server designed to connect Large Language Models to various real-world applications. This project provides a core engine, pluggable service connectors, and a Vite+React frontend for testing.
This monorepo contains:
- /backend: The Node.js MCP server.
- /frontend: A Vite+React control panel.
Features
- Modular Architecture: Easily add new service connectors (e.g., Discord, Slack).
- Secure by Default: Uses
.envfiles to keep all secrets out of version control. - Stateful WhatsApp Connection: Maintains your WhatsApp Web session.
- Real-time Telegram Bot: Connects instantly to the Telegram Bot API.
- React Control Panel: A simple UI to test your server's tools.
Project Setup
Prerequisites
- Node.js (LTS version, e.g., v20.x)
- Git
Installation & Configuration
-
Clone the repository:
bash git clone <your-repo-url> cd universal-mcp-project -
Set Up Backend:
bash cd backend npm install cp .env.example .env
Now, openbackend/.envwith a text editor (nano .env) and add your API keys. -
Set Up Frontend:
bash cd ../frontend npm install cp .env.example .env
The default settings infrontend/.envshould work for local development.
Running the Application
You will need two separate terminal sessions for this.
-
Start the Backend Server:
Open your first terminal, navigate to thebackendfolder, and run:bash npm run dev
On the first run for WhatsApp, a QR code will appear. Scan it with your phone. -
Start the Frontend App:
Open a second terminal, navigate to thefrontendfolder, and run:bash npm run dev
Open your web browser on your phone and go to the URL shown in the terminal (usuallyhttp://localhost:5173).
You should now see the control panel and be able to execute commands through your backend server.
