one-mcp
starsforks
How to install one-mcp?
burugo/one-mcp
$git clone https://github.com/burugo/one-mcpOne MCP - A centralized proxy for Model Context Protocol (MCP) services
README.md
| 1 | <p align="right"> |
| 2 | <strong>English</strong> | <a href="./README.zh.md">中文</a> |
| 3 | </p> |
| 4 | |
| 5 | # One MCP |
| 6 | |
| 7 | <div align="center"> |
| 8 | |
| 9 | **One MCP** - A centralized proxy for Model Context Protocol (MCP) services |
| 10 | |
| 11 | *✨ Manage, monitor, and configure your MCP services from a single interface ✨* |
| 12 | |
| 13 | <br /> |
| 14 | |
| 15 | [](https://goreportcard.com/report/github.com/burugo/one-mcp) |
| 16 | [](https://github.com/burugo/one-mcp/actions) |
| 17 | [](https://github.com/burugo/one-mcp/blob/main/LICENSE) |
| 18 | |
| 19 | [](https://golang.org/) |
| 20 | [](https://reactjs.org/) |
| 21 | [](https://www.typescriptlang.org/) |
| 22 | [](https://hub.docker.com/r/buru2020/one-mcp) |
| 23 | |
| 24 | </div> |
| 25 | |
| 26 | <p align="center"> |
| 27 | <a href="#features">Features</a> • |
| 28 | <a href="#quick-start">Quick Start</a> • |
| 29 | <a href="#installation">Installation</a> • |
| 30 | <a href="#configuration">Configuration</a> • |
| 31 | <a href="#development">Development</a> • |
| 32 | <a href="#contributing">Contributing</a> |
| 33 | </p> |
| 34 | |
| 35 | --- |
| 36 | |
| 37 | ## Overview |
| 38 | |
| 39 | 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. |
| 40 | |
| 41 |  |
| 42 | |
| 43 | ## Features |
| 44 | |
| 45 | - **Service Management** — Install, configure, and monitor MCP services (stdio / SSE / streamable HTTP) from a marketplace or custom sources |
| 46 | - **Service Groups** — Combine multiple MCP services into a single endpoint; export as Anthropic Skills for Claude Code & Droid |
| 47 | - **Analytics** — Track usage, request rates, response times, and system health in real time |
| 48 | - **Multi-User & OAuth** — Role-based access control with GitHub / Google login |
| 49 | - **Flexible Deployment** — SQLite (default) / MySQL / PostgreSQL, optional Redis, Docker ready, i18n (EN / ZH) |
| 50 | |
| 51 |  |
| 52 |  |
| 53 | |
| 54 | ### Service Groups |
| 55 | |
| 56 | Create service groups to combine multiple MCP services and export as Skills: |
| 57 | |
| 58 |  |
| 59 | |
| 60 | ## Quick Start |
| 61 | |
| 62 | ### Using Homebrew (macOS & Linux) |
| 63 | |
| 64 | ```bash |
| 65 | # Add tap |
| 66 | brew tap burugo/tap |
| 67 | |
| 68 | # Install one-mcp |
| 69 | brew install one-mcp |
| 70 | |
| 71 | # Start as background service (default port: 3000) |
| 72 | brew services start one-mcp |
| 73 | |
| 74 | # Stop service |
| 75 | brew services stop one-mcp |
| 76 | ``` |
| 77 | |
| 78 | If port `3000` is already in use, restart with a custom port: |
| 79 | |
| 80 | ```bash |
| 81 | ONE_MCP_PORT=3001 brew services restart one-mcp |
| 82 | ``` |
| 83 | |
| 84 | Access the application at http://localhost:3000 (or your custom port). |
| 85 | |
| 86 | ### Using Docker (Recommended) |
| 87 | |
| 88 | ```bash |
| 89 | # Run with Docker |
| 90 | docker run --name one-mcp -d \ |
| 91 | --restart always \ |
| 92 | -p 3000:3000 \ |
| 93 | -v $(pwd)/data:/data \ |
| 94 | buru2020/one-mcp:latest |
| 95 | |
| 96 | # Access the application |
| 97 | open http://localhost:3000 |
| 98 | ``` |
| 99 | |
| 100 | ### Manual Installation |
| 101 | |
| 102 | ```bash |
| 103 | # Clone the repository |
| 104 | git clone https://github.com/burugo/one-mcp.git |
| 105 | cd one-mcp |
| 106 | |
| 107 | # Set up environment |
| 108 | cp .env_example .env |
| 109 | |
| 110 | bash ./run.sh |
| 111 | ``` |
| 112 | |
| 113 | **Default Login**: Username `root`, Password `123456` |
| 114 | |
| 115 | ## Installation |
| 116 | |
| 117 | ### Prerequisites |
| 118 | |
| 119 | #### Homebrew Installation (macOS & Linux) |
| 120 | |
| 121 | - **Homebrew** installed |
| 122 | |
| 123 | #### Manual Installation |
| 124 | |
| 125 | - **Go**: Version 1.19 or later |
| 126 | - **Node.js**: Version 16 or later |
| 127 | - **Database**: SQLite (default), MySQL, or PostgreSQL |
| 128 | - **Redis**: Optional |
| 129 | |
| 130 | ### Environment Configuration |
| 131 | |
| 132 | Create a `.env` file f |
People who liked this also viewed
6 picksType
- fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.MCP ServersJul 2026
- playwright-mcpPlaywright MCP serverMCP ServersJul 2026
- ext-appsOfficial repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP serversMCP ServersJul 2026
- langchain-mcp-adaptersLangChain 🔌 MCPMCP ServersJul 2026
- mcporterCall MCPs via TypeScript, masquerading as simple TypeScript API. Or package them as cli.MCP ServersJul 2026
- mcp-proxyA bridge between Streamable HTTP and stdio MCP transportsMCP ServersJul 2026
