by burugo
A centralized reverse-proxy platform for MCP servers — manage, group, and export as Skills from a single endpoint.
# Add to your Claude Code skills
git clone https://github.com/burugo/one-mcpOne MCP - A centralized proxy for Model Context Protocol (MCP) services
✨ Manage, monitor, and configure your MCP services from a single interface ✨
One MCP is a comprehensive management platform for Model Context Protocol (MCP) services. Acting as a centralized proxy, it lets you discover, install, configure, and monitor MCP services from various providers. Built with Go and React, it offers both powerful backend capabilities and an intuitive web interface.

No comments yet. Be the first to share your thoughts!

Create service groups to combine multiple MCP services and export as Skills:

# Add tap
brew tap burugo/tap
# Install one-mcp
brew install one-mcp
# Start as background service (default port: 3000)
brew services start one-mcp
# Stop service
brew services stop one-mcp
If port 3000 is already in use, restart with a custom port:
ONE_MCP_PORT=3001 brew services restart one-mcp
Access the application at http://localhost:3000 (or your custom port).
# Run with Docker
docker run --name one-mcp -d \
--restart always \
-p 3000:3000 \
-v $(pwd)/data:/data \
buru2020/one-mcp:latest
# Access the application
open http://localhost:3000
# Clone the repository
git clone https://github.com/burugo/one-mcp.git
cd one-mcp
# Set up environment
cp .env_example .env
bash ./run.sh
Default Login: Username root, Password 123456
Create a .env file from the template:
cp .env_example .env
Key configuration options:
# Server Configuration
PORT=3000
# Database (SQLite is default, MySQL and PostgreSQL are supported)
# SQLite(default)
# SQLITE_PATH=/data/one-mcp.db
# MySQL:
# SQL_DSN=root:password@tcp(localhost:3306)/one_mcp
# PostgreSQL:
# SQL_DSN=postgres://username:password@localhost/database_name?sslmode=disable
# Redis (optional, replace local cache for production environment)
REDIS_CONN_STRING=redis://localhost:6379
# GitHub API (optional, for querying npm's github homepage star count, without this, there will be rate limit issues)
GITHUB_TOKEN=your-github-token
# Add tap
brew tap burugo/tap
# Install one-mcp
brew install one-mcp
# Run in foreground
one-mcp --port 3000
# Or run as system service (default port: 3000)
brew services start one-mcp
# Use a custom service port when 3000 is occupied
ONE_MCP_PORT=3001 brew services restart one-mcp
# Build the Docker image
docker build -t one-mcp .
# Run with docker-compose (recommended)
docker-compose up -d
# Or run directly
docker run -d \
--name one-mcp \
-p 3000:3000 \
-v ./data:/data \
-e PORT=3000 \
one-mcp
Build the application:
./deploy/build.sh
Run the server:
./one-mcp --port 3000
Access the application: Open http://localhost:3000 in your browser
~/.config/one-mcp/config.ini)One MCP supports runtime configuration from an INI file at:
~/.config/one-mcp/config.ini
The runtime priority is:
defaults < config file < environment variables < flags
defaults: built-in defaults (for example port 3000)config file: values from ~/.config/one-mcp/config.inienvironment variables: values like PORT, SQLITE_PATH, ENABLE_GZIPflags: command-line flags like --port (highest priority)On first startup, One MCP automatically creates a minimal default config.ini.
Example config.ini:
PORT=3000
SQLITE_PATH=one-mcp.db
ENABLE_GZIP=true
Notes:
~/.config/one-mcp/config.ini for runtime file-based config.ONE_MCP_PORT, --port) still override config.ini.http://your-domain.comhttp://your-domain.com/oauth/githubhttp://your-domain.comhttp://your-domain.com/oauth/googleNo additional configuration required. Database file is created at ./data/one-mcp.db.
SQL_DSN=username:password@tcp(localhost:3306)/database_name
SQL_DSN=postgres://username:password@localhost/database_name?sslmode=disable
The application provides RESTful APIs for all functionality:
http://localhost:3000/apiapplication/jsonPOST /api/auth/login - User authenticationGET /api/services - List installed servicesPOST /api/services - Install new serviceGET /api/market/search - Search marketplaceGET /api/analytics/usage - Usage statistics# Start development servers
./run.sh
# This will start:
# - Backend server on :3000
# - Frontend dev server on :5173 (with hot reload)
one-mcp/
├── backend/ # Go backend code
├── frontend/ # React frontend code
├── data/ # Database and uploads
├── main.go # Application entry point
├── build.sh # Production build script
└── run.sh # Development script
# Frontend tests
cd frontend && npm test
# Backend tests
go test ./...
For detailed development instructions, see DEVELOPMENT.md.
We welcome contributions! Please see our contributing guidelines:
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
⭐ Star this project if you find it helpful!
Made with ❤️ by the One MCP team