Галоўная / Артыкулы

Сем пытанняў перад запускам лакальнага MCP-сервера

Чэкліст для ізаляцыі лакальных MCP-сервераў на прыкладзе сервера GitHub: кароткачасовыя токены, закрытая сетка, белы спіс выходнага трафіку і зафіксаваныя спісы інструментаў.

Выдавец: REACTAPP.TOP8 хв чытання1726 слоў

Крыніцы: 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 — гэта не служба. У яго няма порту, няма прыўходу і няма меж. Гэта програма, якую агент запускае, якая працуе пад актуальным пользоватэлям і мае доступ да файлаў і сяродавыя сераўніка таго карыстальніка. Пытанні пра правыя, якія агент паказвае, паводзіцца пра тое, што робіць агент, тады калі програма, якая знаходзіцца за вызывам інструмента, вялікі час ужо мае контроль над апаратам.

Лепшыя прыкметы — гэта задаць сявець пытанняяў пры інсталяцыёй і дазволіць адпаведным адпаведзенням кераваць настройкамі.

Сявець пытанняяў

  1. Ці працюе локальна? Серверы MCP на даляйнай адміністрацыі знаходзяцца на апараты трэцьяго стакана і не можаць быць інтэграваныя, таму рэштка пунктав спіску становіцца нерэлевантной. Інодзе гэта ўжо рашэнне, а не факт, і адказальна выбор между даляйнай і локальной адміністрацыяй можа зробіць рэштку шасцях пытанняў непатрэбнымі.
  2. Ці трэбуюцца крантыдатуры? Альбо іх няма, альбо ёсць адзіны конкрэтны крантыдат, які можна назваць.
  3. Дзе яно з’яўляеся на звязак? Альбо короткі, фіксаваны спіс хостаў, альбо будзь-яя URL.
  4. Калі файлы яму трэбуюцца? Одна рабочая прастора, усё або нічога.
  5. Ці яму трэба ўсё іншае з хоста? Сесыя на рабочым столе, сокет, браузер.
  6. Ці яно запускае код, які завантажыла? Як так, тады гэты код трэба зафіксаваць.
  • Сколькіх інструментаў яно працюе, і чы можна якія з іх выключыць? Кожны інструмент збільшае плошчу атакі, а дзеякі серверы дазволяюць скорачыць гэты спіс.
  • На запытанні з першага па шостае можна даць адпаведныя адказы, выкарыстоўваючы саму дакументацыю сервера, прыблізна за дзесяць хвілін, без неабяжнага аналізу выканання. Ля толькі сьпявога запытання ёсць конкрэтныя паказнікі: пасля інсталяцыі дыктуюцца адзіны вызов 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. Правілы, якія яны ствараюць, прыменяюцца да будзь-каго локальнага сервера, які плануецца дадаць у файл налашоўкаў:

    1. Выбірайце кранты, які выгораюць. Аплікацыя GitHub ўступае ў праўах перад персональным токенам доступу. Кантэйнер зберагае ключ падпісаў і стварае новы токен для кожнага выкарыстоўвання, і такі токен сам практычна перастае дзейнаць, без патрэбы чакаць, пакуль хтось яго анулюе.
    2. Налажвайце правыя на вялічыню, а не толькі кранты. Адна база дадзеных і чатыры правыя, пры чым кожны токен несе самэ гэтыя правыя.
    3. Захавайце сетка. Калі няма жадных прызначэных маршрутаў, проксі не ўваходзіць у настройкі, якія сервер можа адхіліць, тады калі -e HTTPS_PROXY — гэта проста запіт.
    4. Утворыце спіс дазволеных пунктавях прызначэння. Адна машына, 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. У замен вы отрымаеце конфігурацыю, якую можна захаваць, тады калі раней проста прыклеіваліся тры лініі без разумеў.

    Спадневанае чытанне

  • Модэль 270M для запытанняў з кальцамі: падышкі ў тачнасці і локальныя перавагі — Дзеяная модэль Gemma-3-270M выбірае першы спосаб знаходжэння адпаведзення для запытанняў з кальцамі, пасягаючы 81 з 95 балоў. Яна прасядзе працэсная тачнасць у пораўнанні з большымі модэлямі, але мае перавагі ў вартасцы, прыватнасці і можлівасці вядомчага выкарыстоўвання. —