Agent

🚀 1MCP Proxy Server

The 1MCP Proxy Server (short for "1MCP") is a tool for centralized management of multiple MCP servers. It enables AI assistants to call servers with different functions through a single interface without directly managing each server.

🚀 Quick Start

Global Configuration File Location

The global configuration file of 1MCP is located at:

• macOS/Linux: ~/.config/1mcp/mcp.json
• Windows: %APPDATA%/1mcp/mcp.json

Configuration File Format Example

{
  "mcpServers": {
    "mcp-server-fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    },
    "server-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "disabled": false
    }
  }
}

Startup Commands

# Standard mode
pnpm dev

# Standard input/output mode
pnpm dev-stdio

✨ Features

• Unified Interface: AI assistants communicate with 1MCP via SSE or HTTP protocols.
• Multi-server Management: Run multiple MCP server instances simultaneously.
• Tag Control: Selectively enable or disable servers through tags.
• Request Routing: Distribute requests to appropriate servers according to requirements.

📚 Documentation

System Architecture Diagram

graph TB
    subgraph "AI 助手"
        A1[Claude Desktop]
        A2[Cursor]
        A3[Cherry Studio]
        A4[Roo Code]
    end

    subgraph "1MCP 代理服务器"
        MCP[1MCP Agent]
    end

    subgraph "MCP 服务器"
        S1[Server 1]
        S2[Server 2]
        S3[Server 3]
    end

    A1 -->|sse| MCP
    A2 -->|sse| MCP
    A3 -->|sse| MCP
    A4 -->|sse| MCP

    MCP --> |sse| S1
    MCP --> |stdio| S2
    MCP --> |stdio| S3

Request Flowchart

sequenceDiagram
    participant 客户端 as AI 助手
    participant 代理服务器 as 1MCP Server
    participant MCP 服务器 as MCP Servers

    客户端->>代理服务器: 发送 MCP 请求
    activate 代理服务器

    代理服务器->>代理服务器: 验证请求
    代理服务器->>代理服务器: 加载配置
    代理服务器->>MCP 服务器: 转发请求
    activate MCP 服务器

    MCP 服务器-->>代理服务器: 响应
    deactivate MCP 服务器

    代理服务器-->>客户端: 转发响应
    deactivate 代理服务器

Tag Usage Instructions

Tag Definition Example

{
  "mcpServers": {
    "web-server": {
      "command": "uvx",
      "args": ["mcp-server-web"],
      "disabled": false,
      "tags": ["web", "http"]
    },
    "file-server": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-file"],
      "disabled": false,
      "tags": ["file", "storage"]
    }
  }
}

Tag Filtering Rules

• Include Tags: --tag=web or --tag=file
• Exclude Tags: --exclude-tag=debug
• Combined Usage: --tag=web --exclude-tag=test

🔧 Technical Details

Project Structure

1mcp/
├── src/              # Source code directory
│   ├── main.ts       # Main program entry
│   └── server.ts     # Proxy server implementation
├── package.json      # Dependency management file
└── tsconfig.json     # TypeScript configuration file

Development Commands

# Install dependencies
pnpm install

# Start the development environment
pnpm dev

# Package and build
pnpm build

For more detailed information, please refer to the Official Documentation.