# One Mcp

> A centralized reverse-proxy platform for MCP servers — manage, group, and export as Skills from a single endpoint.

- **Type:** MCP server
- **Install:** `agentstack add mcp-burugo-one-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [burugo](https://agentstack.voostack.com/s/burugo)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [burugo](https://github.com/burugo)
- **Source:** https://github.com/burugo/one-mcp
- **Website:** https://jieli.app

## Install

```sh
agentstack add mcp-burugo-one-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

English | 中文

# One MCP

**One MCP** - A centralized proxy for Model Context Protocol (MCP) services

*✨ Manage, monitor, and configure your MCP services from a single interface ✨*

[](https://goreportcard.com/report/github.com/burugo/one-mcp)
[](https://github.com/burugo/one-mcp/actions)
[](https://github.com/burugo/one-mcp/blob/main/LICENSE)

[](https://golang.org/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](https://hub.docker.com/r/buru2020/one-mcp)

  Features •
  Quick Start •
  Installation •
  Configuration •
  Development •
  Contributing

---

## Overview

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.

## Features

- **Service Management** — Install, configure, and monitor MCP services (stdio / SSE / streamable HTTP) from a marketplace or custom sources
- **Service Groups** — Combine multiple MCP services into a single endpoint; export as Anthropic Skills for Claude Code & Droid
- **Analytics** — Track usage, request rates, response times, and system health in real time
- **Multi-User & OAuth** — Role-based access control with GitHub / Google login
- **Flexible Deployment** — SQLite (default) / MySQL / PostgreSQL, optional Redis, Docker ready, i18n (EN / ZH)

### Service Groups

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

## Quick Start

### Using Homebrew (macOS & Linux)

```bash
# 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:

```bash
ONE_MCP_PORT=3001 brew services restart one-mcp
```

Access the application at http://localhost:3000 (or your custom port).

### Using Docker (Recommended)

```bash
# 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

```bash
# 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:

```bash
cp .env_example .env
```

Key configuration options:

```bash
# 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)

```bash
# 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

```bash
# 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**:
   ```bash
   ./deploy/build.sh
   ```

2. **Run the server**:
   ```bash
   ./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:

```bash
~/.config/one-mcp/config.ini
```

The runtime priority is:

```text
defaults 

**[⭐ Star this project](https://github.com/burugo/one-mcp)** if you find it helpful!

Made with ❤️ by the One MCP team

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [burugo](https://github.com/burugo)
- **Source:** [burugo/one-mcp](https://github.com/burugo/one-mcp)
- **License:** MIT
- **Homepage:** https://jieli.app

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-burugo-one-mcp
- Seller: https://agentstack.voostack.com/s/burugo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.