MCP 服务器

1MCP Server

一个统一的模型上下文协议（Model Context Protocol，MCP）服务器，将多个 MCP 服务器聚合为一个，从而允许像 Claude Desktop、Cursor 和 Cherry Studio 这样的 AI 助手连接到单个服务器，而不是管理多个实例。

README

1MCP - 适用于所有场景的 MCP 服务器

一个统一的模型上下文协议服务器实现，可将多个 MCP 服务器聚合为一个。

概述

1MCP (One MCP) 旨在简化您使用 AI 助手的方式。无需为不同的客户端（Claude Desktop、Cherry Studio、Cursor、Roo Code、Claude 等）配置多个 MCP 服务器，1MCP 提供了一个单一的、统一的服务器，它可以：

将多个 MCP 服务器聚合到一个统一的接口中
通过消除冗余的服务器实例来减少系统资源的使用
简化不同 AI 助手之间的配置管理
为 AI 模型与外部工具和资源交互提供标准化方式
支持动态配置重新加载，无需重启服务器
处理优雅关闭和资源清理

快速开始

要使 Cursor 使用 Claude Desktop 中已配置的现有 MCP 服务器，请按照以下步骤操作：

使用 Claude Desktop 配置文件运行 1MCP 服务器：

npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json

将 1MCP 服务器添加到您的 Cursor 配置文件 (~/.cursor/mcp.json)：

{
    "mcpServers": {
        "1mcp": {
            "type": "http",
            "url": "http://localhost:3050/sse"
        }
    }
}

尽情享用吧！

用法

您可以使用 npx 直接运行服务器：

# 基本用法（使用 SSE 传输启动服务器）
npx -y @1mcp/agent

# 使用现有的 Claude Desktop 配置
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 使用 stdio 传输代替 SSE
npx -y @1mcp/agent --transport stdio

# 显示所有可用选项
npx -y @1mcp/agent --help

可用选项：

--transport, -t: 选择传输类型 ("stdio" 或 "sse"，默认值: "sse")
--config, -c: 使用特定的配置文件
--port, -P: 更改 SSE 端口 (默认值: 3050)
--host, -H: 更改 SSE 主机 (默认值: localhost)
--tags, -g: 按标签过滤服务器（请参阅下面的“标签”部分）
--help, -h: 显示帮助

理解标签

标签可帮助您控制哪些 MCP 服务器可供不同的客户端使用。可以将标签视为描述每个服务器可以做什么的标签。

如何使用标签

在您的服务器配置中：向每个服务器添加标签以描述其功能

{
  "mcpServers": {
    "web-server": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "tags": ["network", "web"],
      "disabled": false
    },
    "file-server": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Downloads"],
      "tags": ["filesystem"],
      "disabled": false
    }
  }
}

在 stdio 模式下启动 1MCP 时：您可以按标签过滤服务器

# 仅启动带有 "network" 标签的服务器
npx -y @1mcp/agent --transport stdio --tags "network"

# 启动带有 "network" 或 "filesystem" 标签的服务器
npx -y @1mcp/agent --transport stdio --tags "network,filesystem"

使用 SSE 传输时：客户端可以请求带有特定标签的服务器

{
    "mcpServers": {
        "1mcp": {
            "type": "http",
            "url": "http://localhost:3050/sse?tags=network"  // 仅连接到具有网络功能的服务器
        }
    }
}

示例标签：

network: 用于发出 Web 请求的服务器
filesystem: 用于处理文件操作的服务器
memory: 用于提供内存/存储的服务器
shell: 用于运行 shell 命令的服务器
db: 用于处理数据库操作的服务器

配置

全局配置

服务器自动管理全局位置的配置：

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

配置文件格式

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

工作原理

系统架构

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

    subgraph "1MCP Server"
        MCP[1MCP Agent]
    end

    subgraph "MCP Servers"
        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

请求流程

sequenceDiagram
    participant Client as AI Assistant
    participant 1MCP as 1MCP Server
    participant MCP as MCP Servers

    Client->>1MCP: Send MCP Request
    activate 1MCP

    1MCP->>1MCP: Validate Request
    1MCP->>1MCP: Load Config
    1MCP->>MCP: Forward Request
    activate MCP

    MCP-->>1MCP: Response
    deactivate MCP

    1MCP-->>Client: Forward Response
    deactivate 1MCP