hyper-mcp

Быстрый и безопасный MCP-сервер, расширяющий свои возможности с помощью плагинов на WebAssembly.

Что это?

hyper-mcp упрощает добавление возможностей ИИ в ваши приложения. Он работает с Claude Desktop, Cursor IDE и другими MCP-совместимыми приложениями. Пишите плагины на любом языке, компилируемом в WebAssembly, распространяйте их через контейнерные реестры и запускайте где угодно — от облака до граничных устройств.

Возможности

• Пишите плагины на любом языке, компилируемом в WebAssembly
• Распространяйте плагины через стандартные OCI-реестры (например, Docker Hub)
• Основан на Extism для надёжной поддержки плагинов
• Песочница с WASM: возможность ограничивать доступ к сети, файловой системе, памяти
• Достаточно лёгкий для ресурсозависимых сред
• Поддержка транспортного протокола stdio
• Развёртывание где угодно: бессерверные среды, граничные устройства, мобильные устройства, IoT
• Кросс-платформенная совместимость из коробки
• Поддержка префикса имени инструмента для предотвращения коллизий имён инструментов
• Динамическая загрузка и выгрузка плагинов (настраиваемая)

Безопасность

Разработан с учётом безопасности:

• Плагины в песочнице, не имеющие доступа к вашей системе без разрешения
• Безопасное выполнение с ограничением ресурсов
• Безопасное распространение плагинов через контейнерные реестры
• Тонкий контроль доступа к функциям хоста
• OCI-образы плагинов подписываются при публикации и проверяются при загрузке с помощью sigstore.

Установка

Предварительные требования

cosign — необходим для загрузки плагинов из OCI-реестров (oci:// URL).

hyper-mcp проверяет криптографическую подпись каждого OCI-плагина перед его загрузкой, чтобы убедиться, что плагин не был изменён и поступает из доверенного источника. Эта проверка выполняется с помощью вызова CLI-утилиты cosign, которая должна быть установлена и доступна в вашем PATH.

Установите cosign, следуя официальным инструкциям: https://docs.sigstore.dev/cosign/system_config/installation/

Примечание: Если вы используете только URL плагинов file://, http://, https:// или s3://, cosign не нужен. Вы также можете отключить проверку подписи для OCI-плагинов, установив insecure_skip_signature: true в конфигурации или переменную окружения HYPER_MCP_INSECURE_SKIP_SIGNATURE=true, но это не рекомендуется для использования в продакшене.

Установка через Homebrew

hyper-mcp доступен в Homebrew для macOS и Linux в двух местах:

Основной репозиторий Homebrew — не требует настройки tap:

brew install hyper-mcp

Собственный tap (hyper-mcp-rs/tap) — обновляется автоматически при каждом релизе на GitHub, поэтому новые версии появляются сразу:

brew install hyper-mcp-rs/tap/hyper-mcp

Обе команды устанавливают один и тот же бинарный файл. Отдавайте предпочтение формуле из основного репозитория, если только не хотите получить самую последнюю версию сразу после её выхода.

Предустановленные бинарные файлы (релизы GitHub)

Скачайте последний релиз для вашей платформы с GitHub Releases:

Выберите нужную версию и скачайте бинарный файл для вашей архитектуры.

macOS / Linux:

Скачайте файл .tar.gz, распакуйте его и поместите hyper-mcp в /usr/local/bin.

Windows:

Скачайте файл .zip, распакуйте его и поместите hyper-mcp.exe в любую папку, указанную в вашем PATH. Если у вас установлен Rust, вы можете установить hyper-mcp напрямую из crates.io:

cargo install hyper-mcp

Начало работы

1. Создайте файл конфигурации:
   • Linux: $HOME/.config/hyper-mcp/config.json
   • Windows: {FOLDERID_RoamingAppData}\hyper-mcp\config.json. Например: C:\Users\Alice\AppData\Roaming\hyper-mcp\config.json
   • macOS: $HOME/Library/Application Support/hyper-mcp/config.json

{
  "plugins": {
    "time": {
      "url": "oci://ghcr.io/hyper-mcp-rs/time-plugin:latest",
      "description": "Get current time and do time calculations"
    },
    "qr_code": {
      "url": "oci://ghcr.io/hyper-mcp-rs/qrcode-plugin:latest",
      "description": "Generate QR codes from text"
    },
    "hash": {
      "url": "oci://ghcr.io/hyper-mcp-rs/hash-plugin:latest"
    },
    "myip": {
      "url": "oci://ghcr.io/hyper-mcp-rs/myip-plugin:latest",
      "description": "Get your current public IP address",
      "runtime_config": {
        "allowed_hosts": ["1.1.1.1"]
      }
    },
    "fetch": {
      "url": "oci://ghcr.io/hyper-mcp-rs/fetch-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["*"],
        "memory_limit": "100 MB",
      }
    }
  }
}

📖 Подробные параметры конфигурации, включая настройку аутентификации, конфигурацию времени выполнения и расширенные функции, см. в RUNTIME_CONFIG.md

Поддерживаемые схемы URL: - oci:// — для реестров, совместимых с OCI (например, Docker Hub, GitHub Container Registry и т. д.). Требуется cosign для проверки подписей (см. Предварительные требования) - file:// — для локальных файлов - http:// или https:// — для удалённых файлов - s3:// — для объектов Amazon S3 (требуется, чтобы ваши учётные данные AWS были настроены в окружении)

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

$ hyper-mcp

• Использует транспортный протокол stdio.
• Для отладки используйте RUST_LOG=debug.
• Если вы загружаете неподписанный OCI-плагин, необходимо установить флаг insecure_skip_signature или переменную окружения HYPER_MCP_INSECURE_SKIP_SIGNATURE в true

Запуск в режиме SSE/streamable-http: Для этого оберните hyper-mcp в один из множества прокси, поддерживающих сетевые транспорты И создающих экземпляр hyper-mcp для каждого клиентского подключения.

Логирование вывода

hyper-mcp автоматически записывает весь вывод в ежедневно обновляемые файлы логов для целей отладки и мониторинга.

Местоположение логов: - Linux: $HOME/.config/hyper-mcp/logs/mcp-server.log - Windows: {FOLDERID_RoamingAppData}\hyper-mcp\logs\mcp-server.log - macOS: $HOME/Library/Application Support/hyper-mcp/logs/mcp-server.log

Пользовательский путь к логам:

Вы можете переопределить стандартный каталог логов, установив переменную окружения HYPER_MCP_LOG_PATH:

export HYPER_MCP_LOG_PATH=/path/to/your/logs
hyper-mcp

Уровни логирования:

Управляйте детализацией логов с помощью переменной окружения RUST_LOG:

# Info level (default)
RUST_LOG=info hyper-mcp

# Debug level (verbose, useful for troubleshooting)
RUST_LOG=debug hyper-mcp

# Warn level (only warnings and errors)
RUST_LOG=warn hyper-mcp

Особенности: - Ежедневное обновление логов (новый файл создаётся каждый день) - Неблокирующая запись для предотвращения влияния на производительность - Включает временные метки, номера строк и информацию о цели - Безопасно для использования с транспортом stdio (логи не мешают обмену данными MCP)

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

Вы можете настроить hyper-mcp как глобально для всех проектов, так и отдельно для каждого проекта.

1. Для конфигурации на уровне проекта создайте .cursor/mcp.json в корне вашего проекта:

{
  "mcpServers": {
    "hyper-mcp": {
      "command": "/path/to/hyper-mcp"
    }
  }
}

1. Настройте hyper-mcp в параметрах Cursor:

2. Начните использовать инструменты через чат:

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

Каждый релиз на GitHub включает MCP Bundle (.mcpb) для каждой платформы вместе с исходными бинарными файлами:

Скачайте бандл для вашей платформы и дважды щёлкните по нему (или перетащите в Claude Desktop), чтобы открыть диалог установки в один клик. Claude Desktop запросит у вас:

• Файл конфигурации плагина — путь к вашему config.json/config.yaml, содержащему список WASM-плагинов для загрузки (см. Начало работы и config.example.json).
• Включить динамическую загрузку плагинов (необязательно).
• Пропустить проверку подписи OCI (необязательно, не рекомендуется).

Бандл содержит только бинарный файл hyper-mcp. Загрузка плагинов oci:// всё ещё требует наличия cosign в вашем PATH, если не включена опция "Пропустить проверку подписи OCI".

Манифест бандла находится в mcpb/manifest.json и упаковывается для каждой платформы рабочим процессом релиза.

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

Самый быстрый способ — прямое добавление (требуется, чтобы hyper-mcp уже был установлен через Homebrew/cargo):

claude mcp add hyper-mcp -- hyper-mcp --config-file /path/to/config.json

+++++ RUNTIME_CONFIG.ru.md Если у вас установлен Rust, вы можете установить hyper-mcp напрямую из crates.io:

brew install hyper-mcp-rs/tap/hyper-mcp

Конфигурация времени выполнения

Конфигурация hyper-mcp состоит из двух частей:

1. Файл конфигурации (JSON/YAML) — определяет список плагинов и их параметры.
2. Переменные окружения — управляют поведением сервера во время выполнения.

Пример конфигурации

cargo install hyper-mcp

Параметры конфигурации

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

Аутентификация

hyper-mcp поддерживает аутентификацию для защищённых реестров и конечных точек.

Аутентификация OCI

Для доступа к частным OCI-реестрам добавьте объект auth в конфигурацию:

{
  "plugins": {
    "time": {
      "url": "oci://ghcr.io/hyper-mcp-rs/time-plugin:latest",
      "description": "Get current time and do time calculations"
    },
    "qr_code": {
      "url": "oci://ghcr.io/hyper-mcp-rs/qrcode-plugin:latest",
      "description": "Generate QR codes from text"
    },
    "hash": {
      "url": "oci://ghcr.io/hyper-mcp-rs/hash-plugin:latest"
    },
    "myip": {
      "url": "oci://ghcr.io/hyper-mcp-rs/myip-plugin:latest",
      "description": "Get your current public IP address",
      "runtime_config": {
        "allowed_hosts": ["1.1.1.1"]
      }
    },
    "fetch": {
      "url": "oci://ghcr.io/hyper-mcp-rs/fetch-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["*"],
        "memory_limit": "100 MB",
      }
    }
  }
}

Поддерживаемые параметры:

Аутентификация AWS S3

Для доступа к приватным бакетам S3 убедитесь, что ваши учётные данные AWS настроены в окружении (например, через ~/.aws/credentials или переменные окружения AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY).

Динамическая загрузка

При включённой динамической загрузке (dynamic_plugin_loading: true или HYPER_MCP_DYNAMIC_PLUGIN_LOADING=true) hyper-mcp будет:

1. Просматривать каталог конфигурации на наличие новых файлов плагинов (.wasm).
2. Автоматически загружать и регистрировать новые плагины без перезапуска сервера.

⚠️ Безопасность: Динамическая загрузка позволяет загружать плагины без проверки подписи. Используйте её только в доверенных средах.

Расширенные возможности

Пользовательские транспорты

По умолчанию hyper-mcp использует транспорт stdio, но вы можете реализовать собственные транспорты для интеграции с другими системами.

Плагины с состоянием

Плагины могут поддерживать состояние между вызовами. Для этого реализуйте интерфейс StatefulPlugin в вашем WASM-модуле.

Ограничение ресурсов

Вы можете ограничить использование ресурсов плагинами с помощью следующих переменных окружения:

Устранение неполадок

Общие проблемы

1. Ошибка загрузки плагина:

   • Проверьте URL плагина и доступность ресурса.
   • Для OCI-плагинов убедитесь, что установлен cosign и настроена аутентификация.

2. Ошибки подписи:

   • Убедитесь, что плагин подписан и у вас есть открытый ключ для проверки.
   • В качестве временного решения можно установить insecure_skip_signature: true.

3. Проблемы с производительностью:

   • Увеличьте HYPER_MCP_MAX_MEMORY или HYPER_MCP_MAX_FUEL, если плагин требует больше ресурсов.

Логирование

Для получения подробных логов установите:

$ hyper-mcp

Логи будут записаны в файл, указанный в Логирование вывода.

Или установите его из нашего магазина плагинов:

/plugin marketplace add hyper-mcp-rs/hyper-mcp
/plugin install hyper-mcp@hyper-mcp-rs
/reload-plugins

Каталог магазина (.claude-plugin/marketplace.json) и плагин (plugins/hyper-mcp) находятся в этом репозитории. Смотрите README плагина для ознакомления с предварительными требованиями и настройкой.

Доступные плагины

Мы поддерживаем несколько плагинов, чтобы помочь вам начать:

Плагины версии V1

Эти плагины используют интерфейс плагинов версии v1. Хотя они всё ещё поддерживаются, новые плагины должны использовать интерфейс версии v2.

• time: Получение текущего времени и выполнение расчётов времени (Rust)
• qr_code: Генерация QR-кодов (Rust)
• hash: Генерация различных типов хешей (Rust)
• myip: Получение вашего текущего IP-адреса (Rust)
• crypto_price: Получение цен на криптовалюты (Go)
• fs: Операции с файловой системой (Rust)
• github: Плагин для GitHub (Go)
• eval_py: Выполнение Python-кода с помощью RustPython (Rust)
• memory: Позволяет сохранять и извлекать данные из памяти, работает на базе SQLite (Rust)
• crates-io: Получение общей информации о пакетах, проверка последней версии пакета (Rust)
• gomodule: Получение информации о Go-модулях и их версиях (Rust)
• qdrant: Сохранение и извлечение данных из поисковой системы векторов Qdrant (Rust)
• gitlab: Плагин для GitLab (Rust)
• meme_generator: Генератор мемов (Rust)
• think: Инструмент для размышлений (Rust)
• maven: Плагин для Maven (Rust)
• serper: Плагин для веб-поиска Serper (Rust)

Плагины версии V2

Эти плагины используют интерфейс плагинов версии v2. Новые плагины должны использовать этот интерфейс.

• arxiv: Поиск статей на arXiv (Rust)
• context7: Поиск документации библиотек (Rust)
• defuddle: Получение основного содержимого любой страницы в формате Markdown (Rust)
• fetch: Базовое получение веб-страниц (Rust)
• monty: Минимальный, безопасный интерпретатор Python на Rust для использования ИИ (Rust)
• rstime: Получение текущего времени и выполнение расчётов времени (Rust)
• sqlite: Взаимодействие с SQLite (Rust)

Плагины, созданные сообществом

• hackernews: Этот плагин подключается к API Hacker News для получения текущих топ-историй и отображения их с заголовками, оценками, авторами и URL.
• release-monitor-id: Этот плагин получает идентификатор проекта с release-monitoring.org, что помогает отслеживать версии выпущенного ПО.
• yahoo-finance: Этот плагин подключается к API Yahoo Finance для предоставления цен на акции (OHLCV) на основе названия компании или тикера.
• rand16: Этот плагин генерирует случайный 16-байтовый буфер и предоставляет его в формате base64uri — очень полезно для онлайн-криптографии с симметричным ключом.

Документация

• Справочник по встроенным инструментам — Документация по инструментам hyper_mcp-*, включая:
  • hyper_mcp-list_plugins — вывод списка всех загруженных плагинов
  • hyper_mcp-load_plugin — динамическая загрузка плагина во время работы
  • hyper_mcp-unload_plugin — динамическая выгрузка плагина во время работы
• Руководство по конфигурации среды выполнения — Полное руководство по параметрам конфигурации, включая:

- Настройка аутентификации (Basic, Token и Keyring) - Конфигурация времени выполнения плагинов - Соображения безопасности и лучшие практики - Настройка платформенно-специфичного keyring для macOS, Linux и Windows - Устранение неполадок с аутентификацией - Руководство по шаблонам пропуска инструментов - Полное руководство по фильтрации инструментов с помощью шаблонов регулярных выражений: - Синтаксис шаблонов и примеры - Типичные сценарии использования и лучшие практики - Стратегии фильтрации для различных окружений - Продвинутые техники работы с регулярными выражениями - Миграция и устранение неполадок

Создание плагинов

Подробные инструкции по созданию плагинов см. в CREATING_PLUGINS.md.

Готовые шаблоны плагинов на Rust и Go см. в TEMPLATES.md.

Лицензия

Apache 2.0

История звёзд