AIHelms MCP Gateway
AIHelms, MCP-шлюз организации, связывает вызовы с персональными ключами сотрудников и учитывает заданную стоимость инструментов.
- 1 030 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Ключи сотрудников дают доступ к операциям зарегистрированных серверов
- Административные журналы могут сохранять содержимое рабочих запросов
- Платформа хранит учетные данные поставщиков и управляет платным трафиком
Установка
- Работает в
Ручная установка
git clone https://github.com/beizhu-1209/AIHelms.git
cd AIHelms
cp .env.example .envЗадайте секреты в локальном файле, затем выполните `docker compose up -d`. Добавьте внешние MCP-серверы через административную панель.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключи сотрудников дают доступ к операциям зарегистрированных серверов
- Административные журналы могут сохранять содержимое рабочих запросов
- Платформа хранит учетные данные поставщиков и управляет платным трафиком
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AIHelms, MCP-шлюз, открывает сотрудникам доступ к инструментам организации. Администратор добавляет сервер в каталог, обновляет список его инструментов и публикует сервер для пользователей. Сотрудник копирует готовую конфигурацию в свой MCP-клиент. Персональный ключ AIHelms связывает вызов с пользователем и его правами. В административной панели можно просмотреть журналы MCP и задать стоимость вызова каждого инструмента. Шлюз входит в платформу AIHelms, которую разворачивают на своем сервере. Она также подключает API моделей и ведет бюджеты подразделений и проектов. Учетные данные внешних сервисов организация настраивает сама.
Для кого. Администраторам корпоративных MCP-подключений, которые выдают инструменты сотрудникам и учитывают их использование.
Подходит, если
- Несколько сотрудников работают с общими MCP-инструментами через персональные ключи.
- Администратор регистрирует сервер и публикует его в общем каталоге.
- Вызовы сопоставляют с пользователями и внутренними затратами.
- Доступ к моделям и инструментам ведут в одной административной системе.
Не подходит, если
- Нужен один локальный сервер без корпоративного каталога и учета пользователей
- Содержимое запросов и ответов в журналах должно оставаться недоступным администраторам.
- Требуется готовая подписка на модели: платформа не включает доступ к их API
Пример запроса к агенту
Подготовь тестовое MCP-подключение через AIHelms, выдай доступ одному пользователю и покажи его конфигурацию без значения ключа.MCP
- Транспорт
- http, sse
- Авторизация
- API-ключ
Переменные окружения
POSTGRES_PASSWORDобязательная, секрет- Пароль PostgreSQL для этой установки.
SECRET_KEYобязательная, секрет- Ключ подписи сессий платформы.
SUPER_ADMIN_PASSWORDобязательная, секрет- Начальный пароль супер-администратора.
Ограничения
Для установки нужны Docker 20.10 или новее, Compose v2 и сервер минимум с 4 ядрами и 8 ГБ памяти; вместе с платформой запускаются PostgreSQL и Redis. Права внешнего MCP-сервера определяют, какие операции доступны через ключ AIHelms: сам шлюз не превращает их в чтение. Журналы могут сохранять запросы, ответы и метаданные, поэтому заранее ограничьте круг читателей. Для доступа из интернета нужно отдельно настроить шифрование соединения и права входа в панель.
Как отключить. Отзовите ключ пользователя или снимите сервер с публикации в AIHelms и удалите подключение из MCP-клиента. Для остановки всей установки выполните `docker compose down` в ее каталоге. Базу и журналы сохраняйте или удаляйте отдельно по правилам организации.
Частые вопросы
Как развернуть AIHelms?
Клонируйте репозиторий, скопируйте `.env.example` в `.env` и задайте секреты. Затем выполните `docker compose up -d`. Откройте `/admin` по адресу своей установки: начальный логин — `admin`, пароль берется из `SUPER_ADMIN_PASSWORD` в `.env`.
Как сотрудник получает MCP-подключение?
После публикации сервера сотрудник открывает пользовательский портал и копирует конфигурацию для своего клиента. В ней указаны адрес вида `/<имя-сервера>/mcp` и персональный ключ в заголовке `x-litellm-api-key`.
Какие способы связи с сервером поддерживаются?
SSE и Streamable HTTP. Администратор выбирает транспорт и вводит адрес внешнего MCP-сервера вместе с нужными заголовками.
Кто может читать содержимое журналов?
Доступ обычных администраторов задает `LOG_DETAIL_CONTENT_VISIBLE_TO_ADMIN`, добавленный в версии 0.1.26. Супер-администраторы могут читать запросы, ответы и метаданные независимо от этого параметра.
Чем шлюз отличается от самих MCP-серверов?
Он управляет их подключением и доступом. Работу с базами, файлами и внешними сервисами по-прежнему выполняют зарегистрированные серверы.
Какая лицензия у AIHelms?
У репозитория GPL-3.0. Для коммерческого лицензирования автор описывает отдельный вариант; перед распространением измененной сборки выберите подходящие условия.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный шлюз объединяет MCP-серверы внутренних сервисов, проверяет вход пользователя и записывает обращения в журнал.
CLI запускает шлюз к моделям и MCP-инструментам с собственными API-ключами, переводом форматов, маршрутами и журналом запросов.
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Самостоятельно разворачиваемый MCP и A2A шлюз с identity-провайдером, контролем доступа и наблюдаемостью для корпоративных агентов
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
MCP Gateway
mcp-gateway
Обратный прокси и управление жизненным циклом серверов MCP на Kubernetes и Azure от Microsoft: маршрутизация, авторизация, роли. Для команд платформы
Коротко о README
Пользовательский портал открывается по основному адресу установки. Документация HTTP API находится по пути `/api/docs`.