1mcp

Overview

1mcp provides a streamlined solution for managing multiple MCP servers by acting as a central proxy. It automatically discovers and aggregates tools, resources, and prompts from upstream servers, providing transparent routing based on prefixed capability names. The server supports multiple downstream clients simultaneously and features automatic reconnection, real-time updates, fast startup mode, and dynamic configuration hot-reloading without server restarts.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• tools/list

  List all available tools from aggregated upstream servers

  Try:Show me all available toolsTry:List tools from all servers
• tools/call

  Execute a specific tool from any connected upstream server

  Try:Run the playwright___click tool on #submit buttonTry:Execute filesystem___read for /path/to/file
• resources/list

  List all available resources from aggregated upstream servers

  Try:Show all available resourcesTry:List resources from all servers
• resources/read

  Read a specific resource from any connected upstream server

  Try:Read the webpage resource at https://example.comTry:Retrieve document resource from filesystem
• prompts/list

  List all available prompts from aggregated upstream servers

  Try:Show all available promptsTry:List prompts from all servers
• prompts/get

  Retrieve a specific prompt from any connected upstream server

  Try:Get the code_review promptTry:Retrieve the summarize_document prompt

Note: Tool names were inferred from the MCP protocol methods described in the README. The server acts as a proxy and exposes tools from upstream servers with prefixed names (serverName___toolName), but the specific tool names vary based on connec

Comparable tools

Installation

git clone <repository-url>
cd 1mcp
npm install

npm run build

cp config/mcp_servers.json.example config/mcp_servers.json

npm start

{
  "mcpServers": {
    "1mcp": {
      "command": "node",
      "args": ["<path-to-1mcp>/dist/main.js"],
      "env": {
        "CONFIG_PATH": "<path-to-config>/mcp_servers.json"
      }
    }
  }
}

FAQ

How do I add a new MCP server to the proxy?

Simply add the server configuration to mcp_servers.json and save the file. The proxy will automatically detect the change and connect to the new server without restarting.

What transport protocols are supported for upstream servers?

1mcp supports stdio (default), SSE (Server-Sent Events), streamable-http, and auto-detection for connecting to upstream servers.

Can the proxy handle downstream client disconnections?

Yes, the proxy manages client sessions with automatic cleanup. After 30 minutes of inactivity, sessions are automatically cleaned up.

Compare 1mcp with