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

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

Версия НПМ Лицензия НПМ значок кузнеца

Обзор

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

Объединяет несколько серверов MCP в один унифицированный интерфейс
Снижает использование системных ресурсов за счет устранения избыточных экземпляров сервера.
Упрощает управление конфигурацией различных помощников на основе искусственного интеллекта
Предоставляет стандартизированный способ взаимодействия моделей ИИ с внешними инструментами и ресурсами.
Поддерживает динамическую перезагрузку конфигурации без перезапуска сервера
Обеспечивает плавное завершение работы и очистку ресурсов.

Related MCP server: MCP Starter

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

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

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

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

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

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

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

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

Вы можете запустить сервер напрямую, используя 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 доступны для разных клиентов. Думайте о тегах как о метках, которые описывают, что может делать каждый сервер.

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

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

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

При запуске 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"

При использовании транспорта 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 } } }

Как это работает

Архитектура системы

Запрос потока

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-адрес для доступа к инструментам отладки в вашем браузере.

1MCP Server