Семь вопросов, которые следует задать перед запуском локального сервера MCP
Чек-лист для изоляции локальных серверов MCP с использованием среды sandbox, протестированный на сервере GitHub: краткосрочные токены, изолированная сеть, список разрешенных выходящих соединений и фиксированные списки инструментов.
Источники: the seven questions i ask before running a local mcp server — part 2
Установка локального сервера MCP обычно подразумевает вставку фрагмента кода в файл конфигурации:
{
"mcpServers": {
"some-tool": { "command": "npx", "args": ["-y", "some-mcp-server"] }
}
}
Это три строки кода: нет ни отзыва, ни диалога с запросом на разрешения, ни этапа установки, о котором кто-либо действительно задумывается. Стоит остановиться и разобраться, что делают эти строки. Локальный сервер MCP — это не сервис: у него нет порта, нет процедуры входа и нет четких границ. Это программа, которую агент запускает, работающая от имени текущего пользователя с доступом к его файлам и среде. Вопросы о разрешениях, которые отображает агент, показывают, что именно делает агент, тогда как программа, стоящая за вызовом инструмента, уже имеет полный контроль над компьютером.
Лучшей практикой является задание семи вопросов перед установкой, позволяя ответам определять параметры конфигурации.
Семь вопросов
- Работает ли он локально? Серверы MCP в удаленном режиме находятся на машинах сторонних организаций и нельзя их ограничить определенными рамками, из-за чего остальные пункты списка теряют смысл. Иногда это скорее вопрос выбора, чем нечто фиксированное, и тщательный выбор между удаленным и локальным вариантом может сделать остальные шесть вопросов ненужными.
- Требуются ли для работы учетные данные? Либо их вовсе не требуется, либо требуется конкретный учетный элемент, который можно указать.
- Куда происходит подключение? Либо к короткому, фиксированному списку хостов, либо к любому URL вообще.
- Какие файлы необходимы? Один рабочий космос, все файлы или ничего.
- Требуется ли что-то еще от хоста? Сессия рабочего стола, сокет, браузер.
- Запускает ли он код, загруженный из сети? Если да, то этот код требует фиксации.
На вопросы с первого по шестой можно ответить, ознакомившись с собственной документацией сервера, примерно за десять минут, без необходимости изучения исходного кода. Только к седьмому вопросу имеются конкретные данные: после установки достаточно выполнить один вызов tools/list, причем количество инструментов часто превышает ожидания.
Пример: сервер GitHub
| Вопрос | Ответ для сервера GitHub |
|---|---|
| Работает локально? | Да, причем он уже поставляется в виде образа контейнера |
| Учетные данные | Необходимы, так как частные репозитории нельзя читать анонимно |
| Соединяется с | Одним хостом — api.github.com |
| Файлы | Ничего, кроме ключа. Работа осуществляется через API, поэтому на диске нет ни копий, ни файлов с результатами проверки |
| Дополнительные требования к хосту | Ничего |
| Загрузка кода во время выполнения | Нет |
| Список инструментов | Можно сократить с помощью параметров --toolsets и --exclude-tools |
В совокупности эти ответы определяют параметры конфигурации: один учетный данные, отсутствие монтируемой папки, единое место назначения и список инструментов, который следует урезать.
Учетные данные представляют собой сложную часть, поскольку их нельзя исключить из концепции. Если агент создает запросы на слияние, у него должны быть права на запись. Вместо этого используются ограничения, начиная с применения GitHub App вместо личного токена доступа:
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--network",
"mcp-egress-github",
"--read-only",
"--tmpfs",
"/tmp",
"--cap-drop",
"ALL",
"--security-opt",
"no-new-privileges",
"--user",
"10001:10001",
"--log-driver",
"journald",
"-e",
"HTTPS_PROXY=http://mcp-egress-proxy:3128",
"-e",
"HTTP_PROXY=http://mcp-egress-proxy:3128",
"-v",
"/home/<user>/.config/mcp-gh/<app>.private-key.pem:/key.pem:ro",
"ghcr.io/github/github-mcp-server@sha256:508a0857ec762b1ab1cece29193345b501fab1dd9d1228a7b617062954cecac6",
"stdio",
"--app-id",
"NNNNNNN",
"--app-installation-id",
"NNNNNNNNN",
"--app-private-key-path",
"/key.pem",
"--toolsets",
"context,issues,pull_requests,repos",
"--exclude-tools",
"create_repository,fork_repository,get_teams,get_team_members,list_repository_collaborators"
]
}
}
}
Уровни защиты этого удостоверения
- Краткосрочные токены. Приложение GitHub генерирует токены, срок действия которых быстро истекает.
- Чтение только. Ключ подписи монтируется в режиме только для чтения и принадлежит UID, к которому относится контейнер, а не пользователю. Он не находится в папке
~/.ssh, где он уже не был бы SSH-ключом и не мог бы быть прочитан пользователем. - Контейнеры без привилегий. Демон Docker работает в режиме без прав root, процесс использует пользователя, не являющегося root, и ему не предоставляются никакие дополнительные привилегии.
- Один репозиторий, четыре уровня доступа. Для
contents,issuesиpull_requestsразрешен запись, дляmetadata— только чтение, причем каждый сгенерированный токен имеет именно такие права. - Закрытая сеть. Нет прямого выхода наружу, поэтому единственным путем является прокси.
- Список разрешенных выходящих запросов. Все, что создается внутри контейнера, может быть отправлено только на
api.github.com. - Фиксированные наборы инструментов и исключаемые инструменты. Параметр
--toolsetsблокирует целые группы инструментов, а параметр--exclude-toolsудаляет все оставшиеся элементы из этих групп.
Последним двум методам уделяется мало внимания. Ограничение списка инструментов представляет собой минимальный уровень привилегий, необходимый для обеспечения права на запись. Список разрешенных запросов защищает не только локальные файлы, так как он ограничивает возможности использования украденных учетных данных.
Это утверждение требует подтверждения. С помощью параметра --toolsets context,issues,pull_requests,repos сервер предоставляет доступ к 42 инструментам. Пять из них нельзя использовать с данными правами. После применения параметра --exclude-tools остается 37 инструментов, из которых 15 позволяют выполнять операции записи. Поскольку параметр --toolsets выбирает целые группы инструментов, параметр repos включает в себя функции create_repository и fork_repository независимо от того, могут ли они быть использованы токеном. 37 — это немалое число, но оно точное, и именно так выглядит принцип минимальных привилегий, когда агент действительно должен загрузить ветку.
Почему список разрешенных инструментов не является чрезмерным
Сначала кажется, что список разрешенных адресов слишком обширен, пока кто-то не спросит, что он предотвращает. Никто не может заставить контейнер связаться с attacker.com, поэтому токен, созданный внутри него, не имеет возможности попасть во враждебную среду. Журнал прокси фиксирует оба результата каждой попытки:
10.123.2.3 TCP_TUNNEL/200 CONNECT api.github.com:443 HIER_DIRECT/140.82.121.6
10.123.2.3 TCP_DENIED/403 CONNECT example.com:443 HIER_NONE/-
Флаг -e HTTPS_PROXY не является тем элементом, который обеспечивает это. В Linux отсутствует встроенное понятие прокси — ни команда ядра, ни хук библиотеки libc. Эта переменная представляет собой лишь текст в среде, и каждый HTTP-клиент сам решает, будет ли он её учитывать. Библиотека net/http в Go учитывает её, поэтому этому конкретному серверу не требуется дополнительная настройка. Встроенная функция fetch в Node её не учитывает, что означает полное игнорирование этого параметра сервером Node. Защитой служит структура сети: при отсутствии выходного маршрута клиент, игнорирующий переменную, не подключается напрямую, а просто выдает ошибку. В сети с маршрутом такая оплошность может привести к утечке трафика без каких-либо предупреждений.
Сопоставление с списком OWASP MCP Top 10
Соответствие данной конфигурации списку OWASP MCP Top 10 позволяет отметить каждый риск как устранённый, оставшийся или находящийся под контролем, как не устранённый, или как не применимый к локальному серверу stdio, с примечаниями о том, что остаётся нерешённым.
Что всё ещё не входит в объём
Ни один «песочницевый» режим не бывает полным. Три аспекта полностью выходят за рамки данной конфигурации: удалённые серверы MCP, серверы, загружающие произвольные URL, и сама модель.
Далее проблема уже не сводится к забытой настройке. Все эти меры контроля применяются к каждому контейнеру, вводятся вручную и должны копироваться для каждого добавляемого сервера. Трём серверам требуются три списка разрешённого и три строки с набором инструментов, причём ни один компонент не отслеживает сессию в целом.
Отсутствует шлюз, расположенный между агентом и его серверами. Шлюз может полностью удалять инструменты из list_tools и снова проверять каждый запрос перед его передачей, так что список инструментов обновляется для каждой сессии, а не для каждого файла конфигурации. Однако он по-прежнему не может отслеживать поведение работающего сервера: открытые файлы, контактируемые хосты, считываемые учетные данные. Для компрометированного сервера не требуется использование инструментов для отправки ключей в другое место. Шлюз добавляет ещё один уровень обработки, не удаляя существующих.
Правила, применимые к любому локальному серверу
Приведённые выше ответы относятся к GitHub. Правила, которые они предусматривают, применимы к любому локальному серверу, который собираются включить в файл конфигурации:
- Предпочитайте учетные данные с ограниченным сроком действия. Приложение GitHub лучше подходит, чем личный токен доступа. Контейнер хранит ключ подписи и генерирует новый токен при каждом использовании, причем такой токен самостоятельно истекает, без необходимости ожидания отзыва со стороны кого-либо.
- Ограничивайте объем прав, а не только учетные данные. Один репозиторий и четыре вида прав — каждый токен содержит именно их.
- Защищайте сеть. Поскольку предустановленных маршрутов нет, сервер не может отклонить настройку прокси, в то время как параметр
-e HTTPS_PROXYпредставляет собой лишь запрос. - Создавайте список разрешенных адресов. Один хост —
api.github.com. Учетные данные, украденные из этого контейнера, нельзя использовать в других местах, и любая попытка будет зарегистрирована в логах в любом случае.
--user 10001, удалите все привилегии с помощью --cap-drop ALL, добавьте параметр --security-opt no-new-privileges и подключите файловую систему в режиме --read-only, используя tmpfs для временных файлов./key.pem:ro — без какого-либо рабочего пространства. Привязка папки $HOME к контейнеру не считается механизмом изоляции.--toolsets исключает определённые группы инструментов, а --exclude-tools удаляет оставшиеся, в результате чего количество инструментов на сервере сокращается с 42 до 37, причём 15 из них всё ещё могут выполнять операции записи.latest, а также тегов версий, поскольку их можно изменить. Оба изображения в этой конфигурации, включая прокси, используют формат @sha256:…, что предотвращает их изменение.Нет единого правила, определяющего наступление ущерба. Отравленный документ всё равно может заставить агента выполнить запрос к инструменту. Каждое правило ограничивает распространение воздействия, но ни одно не фиксирует момент его активации. Песочница регулирует то, где программа может взаимодействовать, но не то, что она говорит.
Список разрешённых адресов показывает лишь пределы. Он проверяет, что трафик направляется на api.github.com, но ничего не говорит о содержимом. Параметр contents: write позволяет агенту добавлять ветки, а также допускает внедрение инструкций для сохранения файлов. Названия веток, сообщения об изменениях и заголовки задач кажутся невинными по отдельности, но вместе они могут скрыть в репозитории что угодно, доступное для чтения другими. Любой фильтр, достаточно либеральный для работы агента, позволяет данные выходить наружу, поскольку сама работа заключается в чтении и записи на GitHub.
Поэтому рассматривайте всё это как начальный этап, а не финишную черту, и сначала внедрите его. Стоимость состоит из семи вопросов, примерно десяти минут на чтение и одного вызова tools/list. Взамен вы получаете конфигурацию, которую можно защитить, тогда как раньше просто копировались три строки без раздумий.
Связанные материалы
- Защита инструментов MCP с возможностью записи: семь уровней защиты помимо токена — почему токен MCP не предоставляет разрешения на запись в последующих операциях, а также семь уровней контроля, разделение учетных данных, проверка точности запросов и правила повторных попыток, которые обеспечивают защиту.
- Практические рекомендации: Microsoft создала сервер MCP для Playwright, а затем сказала вам, что делать — пошаговое руководство по использованию практических рекомендаций: Microsoft создала сервер MCP для Playwright, а затем сказала вам, что делать: контракты, проверки и готовые блоки кода для команд, внедряющих эту архитектуру.