Service Groups

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

Quick Start

Using Homebrew (macOS & Linux)

# 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).

Using Docker (Recommended)

# 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

Manual Installation

# 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

Installation

Prerequisites

Homebrew Installation (macOS & Linux)

• Homebrew installed

Manual Installation

• Go: Version 1.19 or later
• Node.js: Version 16 or later
• Database: SQLite (default), MySQL, or PostgreSQL
• Redis: Optional

Environment Configuration

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

Homebrew Installation (macOS & Linux)

# 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

Docker Deployment

# 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

Manual Deployment

1. Build the application:

   ./deploy/build.sh
   

2. Run the server:

   ./one-mcp --port 3000
   

3. Access the application: Open http://localhost:3000 in your browser

Configuration

Runtime Configuration (~/.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.ini
• environment variables: values like PORT, SQLITE_PATH, ENABLE_GZIP
• flags: 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:

• One MCP only reads ~/.config/one-mcp/config.ini for runtime file-based config.
• Homebrew service values (ONE_MCP_PORT, --port) still override config.ini.

OAuth Setup

GitHub OAuth

1. Create a GitHub OAuth App at https://github.com/settings/applications/new
2. Set Homepage URL: http://your-domain.com
3. Set Authorization callback URL: http://your-domain.com/oauth/github
4. Configure in the application preferences

Google OAuth

1. Create credentials at https://console.developers.google.com/
2. Set Authorized JavaScript origins: http://your-domain.com
3. Set Authorized redirect URIs: http://your-domain.com/oauth/google
4. Configure in the application preferences

Database Configuration

SQLite (Default)

No additional configuration required. Database file is created at ./data/one-mcp.db.

MySQL

SQL_DSN=username:password@tcp(localhost:3306)/database_name

PostgreSQL

SQL_DSN=postgres://username:password@localhost/database_name?sslmode=disable

API Documentation

The application provides RESTful APIs for all functionality:

• Base URL: http://localhost:3000/api
• Authentication: Bearer token (obtained via login)
• Content-Type: application/json

Key Endpoints

• POST /api/auth/login - User authentication
• GET /api/services - List installed services
• POST /api/services - Install new service
• GET /api/market/search - Search marketplace
• GET /api/analytics/usage - Usage statistics

Development

Development Environment

# Start development servers
./run.sh

# This will start:
# - Backend server on :3000
# - Frontend dev server on :5173 (with hot reload)

Project Structure

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

Testing

# Frontend tests
cd frontend && npm test

# Backend tests
go test ./...

For detailed development instructions, see DEVELOPMENT.md.

Contributing

We welcome contributions! Please see our contributing guidelines:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Guidelines

• Follow Go and TypeScript best practices
• Add tests for new functionality
• Update documentation as needed
• Ensure all tests pass before submitting

Roadmap

Support

• Documentation: Wiki
• Issues: GitHub Issues

License

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