1MCP Server

by 1mcp-app

Integrations

  • Indicated by server-filesystem capability, which likely allows file operations on git repositories

  • Provides platform-specific configurations and file paths for Linux users

  • Provides platform-specific configurations and file paths for macOS users

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

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

Обзор

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

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

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

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

  1. Запустите сервер 1MCP с файлом конфигурации Claude Desktop:
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json
  1. Добавьте сервер 1MCP в файл конфигурации курсора ( ~/.cursor/mcp.json ):
{ "mcpServers": { "1mcp": { "type": "http", "url": "http://localhost:3050/sse" } } }
  1. Наслаждайся этим!

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

Вы можете запустить сервер напрямую, используя 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" или "sse", по умолчанию: "sse")
  • --config, -c : Использовать определенный файл конфигурации
  • --port, -P : Изменить порт SSE (по умолчанию: 3050)
  • --host, -H : Изменить хост SSE (по умолчанию: 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 SSE 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» или «sse», по умолчанию: «sse»)
  • ONE_MCP_PORT : порт SSE (по умолчанию: 3050)
  • ONE_MCP_HOST : хост SSE (по умолчанию: "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 } } }
  1. При запуске 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"
  1. При использовании транспорта 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 } } }

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

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

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

Разработка

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

pnpm install

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

pnpm build

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

pnpm watch

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

pnpm dev

Отладка

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

pnpm inspector

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

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Унифицированный сервер Model Context Protocol, объединяющий несколько серверов MCP в один, что позволяет помощникам на основе искусственного интеллекта, таким как Claude Desktop, Cursor и Cherry Studio, подключаться к одному серверу вместо управления несколькими экземплярами.

  1. Обзор
    1. Быстрый старт
      1. Использование
        1. Докер
          1. Переменные среды
          2. Понимание тегов
        2. Конфигурация
          1. Глобальная конфигурация
          2. Формат файла конфигурации
        3. Как это работает
          1. Архитектура системы
          2. Запрос потока
        4. Разработка
          1. Отладка

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.
          Last updated -
          17
          77
          7
          TypeScript
          Apache 2.0
          • Apple
          • Linux
        • A
          security
          F
          license
          A
          quality
          Model Context Protocol (MCP) server that integrates Redash with AI assistants like Claude, allowing them to query data, manage visualizations, and interact with dashboards through natural language.
          Last updated -
          10
          53
          16
          JavaScript
          • Apple
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that connects Claude and other MCP clients to Aider, enabling AI assistants to efficiently edit files, create new files, and interact with git repositories through natural language.
          Last updated -
          9
          Python
          The Unlicense
          • Linux
          • Apple
        • -
          security
          F
          license
          -
          quality
          A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
          Last updated -
          TypeScript
          • Apple

        View all related MCP servers

        ID: ttsuowc5pm