1MCP — один сервер MCP для всех

Унифицированная реализация сервера Model Context Protocol, объединяющая несколько серверов MCP в один.

Обзор

1MCP (One MCP) разработан для упрощения работы с помощниками AI. Вместо настройки нескольких серверов MCP для разных клиентов (Claude Desktop, Cherry Studio, Cursor, Roo Code, Claude и т. д.), 1MCP предоставляет единый унифицированный сервер, который:

• Объединяет несколько серверов MCP в один унифицированный интерфейс

• Снижает использование системных ресурсов за счет устранения избыточных экземпляров сервера.

• Упрощает управление конфигурацией различных помощников на основе искусственного интеллекта

• Предоставляет стандартизированный способ взаимодействия моделей ИИ с внешними инструментами и ресурсами.

• Поддерживает динамическую перезагрузку конфигурации без перезапуска сервера

• Обеспечивает плавное завершение работы и очистку ресурсов.

Related MCP server: OpenRouter MCP Server

Быстрый старт

Чтобы включить Cursor для использования существующих серверов MCP, уже настроенных в Claude Desktop, выполните следующие действия:

1. Запустите сервер 1MCP с файлом конфигурации Claude Desktop:

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

2. Добавьте сервер 1MCP в файл конфигурации курсора ( ~/.cursor/mcp.json ):

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

3. Наслаждайся этим!

Использование

Вы можете запустить сервер напрямую, используя npx :

# Basic usage (starts server with SSE transport)
npx -y @1mcp/agent

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

# Use stdio transport instead of SSE
npx -y @1mcp/agent --transport stdio

# Show all available options
npx -y @1mcp/agent --help

Доступные варианты:

• --transport, -t : выбрать тип транспорта («stdio» или «http», по умолчанию: «http»)

• --config, -c : Использовать определенный файл конфигурации

• --port, -P : Изменить HTTP-порт (по умолчанию: 3050)

• --host, -H : Изменить HTTP-хост (по умолчанию: localhost)

• --tags, -g : Фильтрация серверов по тегам (см. раздел «Теги» ниже)

• --help, -h : Показать справку

Пример с переменными окружения:

# Using environment variables
ONE_MCP_PORT=3051 ONE_MCP_TAGS=network,filesystem npx -y @1mcp/agent

# Or in your shell configuration
export ONE_MCP_PORT=3051
export ONE_MCP_TAGS=network,filesystem
npx -y @1mcp/agent

Докер

Вы также можете запустить 1MCP с помощью Docker:

# Pull the latest image
docker pull ghcr.io/1mcp-app/agent:latest

# Run with HTTP transport (default)
docker run -p 3050:3050 ghcr.io/1mcp-app/agent

# Run with a custom config file
docker run -p 3050:3050 -v /path/to/config.json:/config.json ghcr.io/1mcp-app/agent --config /config.json

# Run with stdio transport
docker run -i ghcr.io/1mcp-app/agent --transport stdio

Доступные теги изображений:

• latest : Последняя стабильная версия

• vX.YZ : Конкретная версия (например, v1.0.0 )

• sha-<commit> : Конкретный коммит

Переменные среды

Вы можете настроить 1MCP, используя переменные среды с префиксом ONE_MCP_ :

• ONE_MCP_TRANSPORT : Тип транспорта («stdio» или «http», по умолчанию: «http»)

• ONE_MCP_PORT : HTTP-порт (по умолчанию: 3050)

• ONE_MCP_HOST : HTTP-хост (по умолчанию: «localhost»)

• ONE_MCP_CONFIG : Путь к файлу конфигурации

• ONE_MCP_TAGS : список тегов, разделенных запятыми, для фильтрации серверов

Пример с переменными окружения:

docker run -p 3051:3051 \
  -e ONE_MCP_PORT=3051 \
  -e ONE_MCP_TAGS=network,filesystem \
  ghcr.io/1mcp-app/agent

Понимание тегов

Теги помогают вам контролировать, какие серверы MCP доступны для разных клиентов. Думайте о тегах как о метках, которые описывают, что может делать каждый сервер.

Как использовать теги

1. В конфигурации вашего сервера : добавьте теги к каждому серверу, чтобы описать его возможности.

{
  "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
    }
  }
}

2. При запуске 1MCP в режиме stdio : Вы можете фильтровать серверы по тегам

# Only start servers with the "network" tag
npx -y @1mcp/agent --transport stdio --tags "network"

# Start servers with either "network" or "filesystem" tags
npx -y @1mcp/agent --transport stdio --tags "network,filesystem"

3. При использовании транспорта SSE : клиенты могут запрашивать серверы с определенными тегами.

{
    "mcpServers": {
        "1mcp": {
            "type": "http",
            "url": "http://localhost:3050/sse?tags=network"  // Only connect to network-capable servers
        }
    }
}

Примеры тегов:

• network : Для серверов, которые делают веб-запросы

• filesystem : для серверов, обрабатывающих файловые операции

• memory : для серверов, которые предоставляют память/хранилище

• 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 -->|http| MCP
    A2 -->|http| MCP
    A3 -->|http| MCP
    A4 -->|http| MCP

    MCP --> |http| 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

Разработка

Установить зависимости:

pnpm install

Сборка сервера:

pnpm build

Для разработки с автоматической пересборкой:

pnpm watch

Запустите сервер:

pnpm dev

Отладка

Использование MCP Inspector , который доступен в виде пакетного скрипта:

pnpm inspector

Инспектор предоставит URL-адрес для доступа к инструментам отладки в вашем браузере.