Skip to content
Back to search

one-mcp

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/burugo--one-mcp/badge.svg)](/listings/burugo--one-mcp)

HTML

<a href="/listings/burugo--one-mcp"><img src="/api/listings/burugo--one-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 366 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="right">
  2. <strong>English</strong> | <a href="./README.zh.md">中文</a>
  3. </p>
  4. # One MCP
  5. <div align="center">
  6. **One MCP** - A centralized proxy for Model Context Protocol (MCP) services
  7. *✨ Manage, monitor, and configure your MCP services from a single interface ✨*
  8. <br />
  9. [![Go Report Card](https://goreportcard.com/badge/github.com/burugo/one-mcp?style=flat-square)](https://goreportcard.com/report/github.com/burugo/one-mcp)
  10. [![Go CI](https://img.shields.io/github/actions/workflow/status/burugo/one-mcp/go.yml?style=flat-square&logo=github&label=Go%20CI)](https://github.com/burugo/one-mcp/actions)
  11. [![GitHub license](https://img.shields.io/github/license/burugo/one-mcp?style=flat-square)](https://github.com/burugo/one-mcp/blob/main/LICENSE)
  12. [![Go](https://img.shields.io/badge/Go-1.19+-00ADD8?style=flat-square&logo=go&logoColor=white)](https://golang.org/)
  13. [![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat-square&logo=react&logoColor=black)](https://reactjs.org/)
  14. [![TypeScript](https://img.shields.io/badge/TypeScript-5+-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
  15. [![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white)](https://hub.docker.com/r/buru2020/one-mcp)
  16. </div>
  17. <p align="center">
  18. <a href="#features">Features</a> •
  19. <a href="#quick-start">Quick Start</a> •
  20. <a href="#installation">Installation</a> •
  21. <a href="#configuration">Configuration</a> •
  22. <a href="#development">Development</a> •
  23. <a href="#contributing">Contributing</a>
  24. </p>
  25. ---
  26. ## Overview
  27. 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.
  28. ![Screenshot](./images/dashboard.png)
  29. ## Features
  30. - **Service Management** — Install, configure, and monitor MCP services (stdio / SSE / streamable HTTP) from a marketplace or custom sources
  31. - **Service Groups** — Combine multiple MCP services into a single endpoint; export as Anthropic Skills for Claude Code & Droid
  32. - **Analytics** — Track usage, request rates, response times, and system health in real time
  33. - **Multi-User & OAuth** — Role-based access control with GitHub / Google login
  34. - **Flexible Deployment** — SQLite (default) / MySQL / PostgreSQL, optional Redis, Docker ready, i18n (EN / ZH)
  35. ![Screenshot](./images/services.png)
  36. ![Screenshot](./images/copy_config.png)
  37. ### Service Groups
  38. Create service groups to combine multiple MCP services and export as Skills:
  39. ![Screenshot](./images/group.png)
  40. ## Quick Start
  41. ### Using Homebrew (macOS & Linux)
  42. ```bash
  43. # Add tap
  44. brew tap burugo/tap
  45. # Install one-mcp
  46. brew install one-mcp
  47. # Start as background service (default port: 3000)
  48. brew services start one-mcp
  49. # Stop service
  50. brew services stop one-mcp
  51. ```
  52. If port `3000` is already in use, restart with a custom port:
  53. ```bash
  54. ONE_MCP_PORT=3001 brew services restart one-mcp
  55. ```
  56. Access the application at http://localhost:3000 (or your custom port).
  57. ### Using Docker (Recommended)
  58. ```bash
  59. # Run with Docker
  60. docker run --name one-mcp -d \
  61. --restart always \
  62. -p 3000:3000 \
  63. -v $(pwd)/data:/data \
  64. buru2020/one-mcp:latest
  65. # Access the application
  66. open http://localhost:3000
  67. ```
  68. ### Manual Installation
  69. ```bash
  70. # Clone the repository
  71. git clone https://github.com/burugo/one-mcp.git
  72. cd one-mcp
  73. # Set up environment
  74. cp .env_example .env
  75. bash ./run.sh
  76. ```
  77. **Default Login**: Username `root`, Password `123456`
  78. ## Installation
  79. ### Prerequisites
  80. #### Homebrew Installation (macOS & Linux)
  81. - **Homebrew** installed
  82. #### Manual Installation
  83. - **Go**: Version 1.19 or later
  84. - **Node.js**: Version 16 or later
  85. - **Database**: SQLite (default), MySQL, or PostgreSQL
  86. - **Redis**: Optional
  87. ### Environment Configuration
  88. Create a `.env` file from the template:
  89. ```bash
  90. cp .env_example .env
  91. ```
  92. Key configuration options:
  93. ```bash
  94. # Server Configuration
  95. PORT=3000
  96. # Database (SQLite is default, MySQL and PostgreSQL are supported)
  97. # SQLite(default)
  98. # SQLITE_PATH=/data/one-mcp.db
  99. # MySQL:
  100. # SQL_DSN=root:password@tcp(localhost:3306)/one_mcp
  101. # PostgreSQL:
  102. # SQL_DSN=postgres://username:password@localhost/database_name?sslmode=disable
  103. # Redis (optional, replace local cache for production environment)
  104. REDIS_CONN_STRING=redis://localhost:6379
  105. # GitHub API (optional, for querying npm's github homepage star count, without this, there will be rate limit issues)
  106. GITHUB_TOKEN=your-github-token
  107. ```
  108. ### Homebrew Installation (macOS & Linux)
  109. ```bash
  110. # Add tap
  111. brew tap burugo/tap
  112. # Install one-mcp
  113. brew install one-mcp
  114. # Run in foreground
  115. one-mcp --port 3000
  116. # Or run as system service (default port: 3000)
  117. brew services start one-mcp
  118. # Use a custom service port when 3000 is occupied
  119. ONE_MCP_PORT=3001 brew services restart one-mcp
  120. ```
  121. ### Docker Deployment
  122. ```bash
  123. # Build the Docker image
  124. docker build -t one-mcp .
  125. # Run with docker-compose (recommended)
  126. docker-compose up -d
  127. # Or run directly
  128. docker run -d \
  129. --name one-mcp \
  130. -p 3000:3000 \
  131. -v ./data:/data \
  132. -e PORT=3000 \
  133. one-mcp
  134. ```
  135. ### Manual Deployment
  136. 1. **Build the application**:
  137. ```bash
  138. ./deploy/build.sh
  139. ```
  140. 2. **Run the server**:
  141. ```bash
  142. ./one-mcp --port 3000
  143. ```
  144. 3. **Access the application**:
  145. Open http://localhost:3000 in your browser
  146. ## Configuration
  147. ### Runtime Configuration (`~/.config/one-mcp/config.ini`)
  148. One MCP supports runtime configuration from an INI file at:
  149. ```bash
  150. ~/.config/one-mcp/config.ini
  151. ```
  152. The runtime priority is:
  153. ```text
  154. defaults < config file < environment variables < flags
  155. ```
  156. - `defaults`: built-in defaults (for example port `3000`)
  157. - `config file`: values from `~/.config/one-mcp/config.ini`
  158. - `environment variables`: values like `PORT`, `SQLITE_PATH`, `ENABLE_GZIP`
  159. - `flags`: command-line flags like `--port` (highest priority)
  160. On first startup, One MCP automatically creates a minimal default `config.ini`.
  161. Example `config.ini`:
  162. ```ini
  163. PORT=3000
  164. SQLITE_PATH=one-mcp.db
  165. ENABLE_GZIP=true
  166. ```
  167. Notes:
  168. - One MCP only reads `~/.config/one-mcp/config.ini` for runtime file-based config.
  169. - Homebrew service values (`ONE_MCP_PORT`, `--port`) still override `config.ini`.
  170. ### OAuth Setup
  171. #### GitHub OAuth
  172. 1. Create a GitHub OAuth App at https://github.com/settings/applications/new
  173. 2. Set Homepage URL: `http://your-domain.com`
  174. 3. Set Authorization callback URL: `http://your-domain.com/oauth/github`
  175. 4. Configure in the application preferences
  176. #### Google OAuth
  177. 1. Create credentials at https://console.developers.google.com/
  178. 2. Set Authorized JavaScript origins: `http://your-domain.com`
  179. 3. Set Authorized redirect URIs: `http://your-domain.com/oauth/google`
  180. 4. Configure in the application preferences
  181. ### Database Configuration
  182. #### SQLite (Default)
  183. No additional configuration required. Database file is created at `./data/one-mcp.db`.
  184. #### MySQL
  185. ```bash
  186. SQL_DSN=username:password@tcp(localhost:3306)/database_name
  187. ```
  188. #### PostgreSQL
  189. ```bash
  190. SQL_DSN=postgres://username:password@localhost/database_name?sslmode=disable
  191. ```
  192. ## API Documentation
  193. The application provides RESTful APIs for all functionality:
  194. - **Base URL**: `http://localhost:3000/api`
  195. - **Authentication**: Bearer token (obtained via login)
  196. - **Content-Type**: `application/json`
  197. ### Key Endpoints
  198. - `POST /api/auth/login` - User authentication
  199. - `GET /api/services` - List installed services
  200. - `POST /api/services` - Install new service
  201. - `GET /api/market/search` - Search marketplace
  202. - `GET /api/analytics/usage` - Usage statistics
  203. ## Development
  204. ### Development Environment
  205. ```bash
  206. # Start development servers
  207. ./run.sh
  208. # This will start:
  209. # - Backend server on :3000
  210. # - Frontend dev server on :5173 (with hot reload)
  211. ```
  212. ### Project Structure
  213. ```
  214. one-mcp/
  215. ├── backend/ # Go backend code
  216. ├── frontend/ # React frontend code
  217. ├── data/ # Database and uploads
  218. ├── main.go # Application entry point
  219. ├── build.sh # Production build script
  220. └── run.sh # Development script
  221. ```
  222. ### Testing
  223. ```bash
  224. # Frontend tests
  225. cd frontend && npm test
  226. # Backend tests
  227. go test ./...
  228. ```
  229. For detailed development instructions, see [DEVELOPMENT.md](./DEVELOPMENT.md).
  230. ## Contributing
  231. We welcome contributions! Please see our contributing guidelines:
  232. 1. **Fork** the repository
  233. 2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
  234. 3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
  235. 4. **Push** to the branch (`git push origin feature/amazing-feature`)
  236. 5. **Open** a Pull Request
  237. ### Development Guidelines
  238. - Follow Go and TypeScript best practices
  239. - Add tests for new functionality
  240. - Update documentation as needed
  241. - Ensure all tests pass before submitting
  242. ## Roadmap
  243. ## Support
  244. - **Documentation**: [Wiki](https://github.com/burugo/one-mcp/wiki)
  245. - **Issues**: [GitHub Issues](https://github.com/burugo/one-mcp/issues)
  246. ## License
  247. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  248. ---
  249. <div align="center">
  250. **[⭐ Star this project](https://github.com/burugo/one-mcp)** if you find it helpful!
  251. Made with ❤️ by the One MCP team
  252. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.