mcpField
M
mcp-one

mcp-one

Local
mcphub.cloudDeveloper Tools8Updated 79w ago
RepositoryVisit website

About mcp-one

mcp-one is a unified MCP server that manages multiple configured MCP servers behind one entry point. It is intended for MCP client users who want to connect through a single SSE endpoint, with support for adding servers through configuration.

Key features

  1. 01Unified entry point for MCP servers
  2. 02Configuration-based server management
  3. 03SSE endpoint for clients
  4. 04Build and Docker deployment instructions

Use cases

  1. 01Connect an MCP client to configured servers through one endpoint
  2. 02Add supported servers such as time-mcp and mcp-server-fetch
  3. 03Deploy the unified server with Docker

MCP support

It presents configured MCP servers through one MCP server endpoint. Clients can connect using the SSE URL, and additional servers can be listed in the configuration.

#mcp#llm#mcp-server#mcp-client

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "one": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "localhost/mcp-one:latest"
      ]
    }
  }
}
Run commanddocker run -i --rm localhost/mcp-one:latest

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocilocalhost/mcp-one:latest

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-one

A unified All-in-One entrance for mcpservers, which manages various types of rated mcpservers.

🤔 What you need is only one mcpserver! 🎉

You are welcome submit PR or issue to make mcp-one more powerful 💪

Example

add to cherry studio/ or cursor, all support.

CleanShot 2025-04-23 at 23 11 46@2x

How to use

mcpone -c mcpserver-config.yaml

Usage:
  mcpone -c mcpserver-config.yaml [flags]

Flags:
      -- string                          mcpServers list config
      --add_dir_header                   If true, adds the file directory to the header of the log messages
      --alsologtostderr                  log to standard error as well as files (no effect when -logtostderr=true)
      --baseurl string                   mcpoone server listen address
  -c, --config string                    config file of mcpone (default "mcpone-config.yaml")
start mcp-one server

./mcp-one -c ./mcpone-config.yaml --baseurl 0.0.0.0:9090

Add sse client to your client, http://localhost:9090/sse. You can also hosted in your server.

build
git clone https://github.com/MCPHubCloud/mcp-one.git
cd mcp-one
make build
# target output in _output/mcp-one
docker deploy
make dockerbuild
docker run -it --rm localhost/mcp-one:latest

Support MCP Servers

mcp-one already supported servers, you can add more in mcpserver-config.yaml just like client. Welcome submit PR to this project

  • time-mcp
  • mcp-server-fetch

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.