π Local DeploymentΒΆ
This guide walks you through running MCP Gateway on your local machine using a virtual environment or directly via Python.
π One-Liner SetupΒΆ
The easiest way to start the server in development mode:
This does the following:
- Creates a
.venv/
virtual environment - Installs all dependencies (including dev tools)
- Launches Gunicorn on
http://localhost:4444
π§ͺ Development Mode with Live ReloadΒΆ
If you want auto-reload on code changes:
Ensure your
.env
file includes:
π Database ConfigurationΒΆ
By default, MCP Gateway uses SQLite for simplicity. You can configure alternative databases via the DATABASE_URL
environment variable:
MariaDB Setup
Install and configure MariaDB server:
# Ubuntu/Debian
sudo apt update && sudo apt install mariadb-server
# Create database and user
sudo mariadb -e "CREATE DATABASE mcp;"
sudo mariadb -e "CREATE USER 'mysql'@'localhost' IDENTIFIED BY 'changeme';"
sudo mariadb -e "GRANT ALL PRIVILEGES ON mcp.* TO 'mysql'@'localhost';"
sudo mariadb -e "FLUSH PRIVILEGES;"
MySQL Setup
Install and configure MySQL server:
# Ubuntu/Debian
sudo apt update && sudo apt install mysql-server
# Create database and user
sudo mysql -e "CREATE DATABASE mcp;"
sudo mysql -e "CREATE USER 'mysql'@'localhost' IDENTIFIED BY 'changeme';"
sudo mysql -e "GRANT ALL PRIVILEGES ON mcp.* TO 'mysql'@'localhost';"
sudo mysql -e "FLUSH PRIVILEGES;"
MariaDB & MySQL Full Compatibility
MariaDB and MySQL are fully supported with:
- 36+ database tables working perfectly with MariaDB 12.0+ and MySQL 8.4+
- All VARCHAR length issues resolved for MariaDB/MySQL compatibility
- Complete feature parity with SQLite and PostgreSQL
π§ͺ Health TestΒΆ
Expected output:
π Admin UIΒΆ
Visit http://localhost:4444/admin and login using your BASIC_AUTH_USER
and BASIC_AUTH_PASSWORD
from .env
.