Падключаем LM Studio да MCP-сервераў: файлы, GitHub і браўзер

Модэлі, які працуюць выключна на вашай сабе машыне, цяпер можаць выклікаць рэальныя інструменты, а не проста гаварыць пра яны. Падключэнне локальной модэлі да такога чаго-небудзь, як GitHub, раней значыла стварэнне персональнага токена доступу вручную і надзею, што ён патрапіць у правыя поля JSON. Большая частка такіх трудносцей знікла. LM Studio можа быць падключаны да трох MCP-сервераў — для файлавой сістэмы, GitHub і кантролю прывідара — з рабочым налашоўкам для кожнага з іх.

Што трэба падготавіць

Перш чым працаваць з mcp.json, трэба падготавіць калькі рэчаў.

LM Studio 0.4.10 або новейшая версія. У гэтай версіі быў даданы падтрымкі OAuth для MCP-сервераў, і яна адпавядае версіі 0.3.17, калі LM Studio пачаў выступаць як хост MCP. Абнаўленні выходзяць часта, апошнім часам кожны месяц выходзяць калькі точных апдэйтаў, таму найпростае — запрацаваць ся з актуальной версіяй.

Мадэль, якая можа выканаліць запыты да інструментаў. Не кожная локальная мадэль робіць гэта надзеямо. Для GPU з 20 ГБ відэамэморыі існуе тры надзеяныя выбары:

• Qwen3-Coder-30B-A3B-Instruct мае 30 мільярда параметраў усьго, але заўсёды толькі апошнія 3,3 мільярда на токен заўсёды актываныя заводзкае дызайну MoE. У фармаце 4-бітнае ёй трэба прыблізна 17–20 ГБ, а таксама ёй прызначана вікна кантэксту 262 тысячы.
• gpt-oss-20b займае менша колькасць мэморыі — апошнія 14 ГБ, і працюе значна быстрэй, што ўжо корыстна, калі карту дзеляе з іншымі працэсамі.
• Qwen3.5-9B — гэта самы лёгкі мадэль, ўпакоўкаваны ў 9B параметраў, якій для працы у 4-бітным фармаце трэба адносна 6GB памяці, таму карты серэдней класы маюць достатню свободу. Ён выкарыстоўвае 262K элементаў власнага кантэксту, якія ёсць у модэлі Coder, можа натычна вызываць інструменты з прыемным рэйтынгам BFCL-V4, і ягое зображэнне паказана ў тутэйшых скрыншотах. Гэта лепшы варыянт для пачатку, калі неясна, чы можа карта адрабатваць болей вялікія мадэлі.

Базовыя мадэлі без налаштаванняў для інструкцый чы размовы зазвычай воабшта не будуць ствараць структураваныя вызывы інструментаў. Калі у опісе модэлі няма нічога пра выкарыстоўванне інструментаў чы вызывы функцый, лепш выбраць варыянт з падтрымкай інструкцый.

Node.js 18 чы новейшая версія. Як сервер файловай сістэмы, так і сервер керування браузерам запускаюцца за дапамогою npx. Адначы спачатку пераканайцеся ў версіі:

node --version

Будзе працаваць любы варыянт, які пачынаецца з v18 або новейшай версіі. Калі команда не знаходзіцца, значыць Node не встановлена, і npx таксама не будзе існаваць. Іншая шырока перапрацоўка стосуецца самога npx:

npx --version

У яго ўключаны Node, таму ён практычна завжды праходзіт тэст, калі першы тэст пройшоў, але гэта просты тэст на правільнасць перш чым паслугвацца ім для налаштавання файловай сістэмы і прыстрою браузера.

Нічыя з гэтых дастатковаў не паказвае версію самога LM Studio. Яна апісваецца у пярэдней часткі вікна прыложэння, і там павінна быць напісана 0.4.10 або новейшая версія.

На выкладзенай вышэ скрыншоце паказана установка, дзе ў пярэдней часткі вікна апісана версія 0.4.23, якая была актуальная ў той момент.

Ачынэнне файла налаштавання

Ачыніце вкладку Integrations у правай панелі LM Studio, нажміце Install, а потым Edit mcp.json. Гэта той рэдагувальнік, дзе кожны сервер мае свой запіс.

Налаштавання 1: файловая сістэма

За дапамою гэтага элемента, выявленне таго, што знаходзіцца ў папкі, больш не являецца монотанай задачай копіювання-выклейвання, а стае простым запітам. Oficый сервер файлавой сістэмы дазваляе модэлю чытаць, запісваць, шукаць і пераказваць спіс дырэктарый, але толькі ў маршрутах, якія вы задаеце.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/projects"
      ]
    }
  }
}

Заменіце /Users/you/projects на папку, яюю мадэль должна аналізаваць. Можна дадаць большыя колькасці шляхоў. Усё, што знаходзіцца за межамі гэтых папак, для мадэлі будзе закрытым, і гэта якраз тая сама абмежэнне. Две часткі даных пры введзенні маюць значэнне:

• command і args означаюць запуск команды npx -y @modelcontextprotocol/server-filesystem за супакоўкай з дазволеным каталогам, які керуецца як падпроцэс LM Studio.
• Параметр allowed-directory вызначае абмежэння таго, да чаго можа дасягнуць мадэль. Праект, які распаўляецца на калькі папак, можа перыявіць іх адна за другой.

Пасля зберагання LM Studio адкрывае новы элемент. Завантажыце мадэль, якая падтрымлівае вызовы інструментаў (Qwen 3.5 9B падходзіць), запачніце новы чат і увяліце mcp/filesystem у бокавай панелі.

Хорашым першым тэстам ёсць запрос пра знаходжэнне файла TODO.md у папцы праектаў і стварэнне апূরкі заставочных задач. Мадэль сама запускае функцыі list_directory і read_file. Перад кожным запускам LM Studio практыкуе дыялогавое падтверджэння, і важкае ўважліва чытаць гэтыя паведамлення, адколі локальная мадэль, якая мае права на зберагчык, не должна працаваць без нагляду.

Канфігурацыя 2: GitHub

Гэтая канфігурацыя выклікае LM Studio 0.4.10 або новейшую версію. Рэмтэйнт MCP ад GitHub не падтрымляе функцыю Dynamic Client Registration, якая зазвычай вікорыстоўваецца для самастойнай рэгістрацыі кліента ў сістэме OAuth. У рэзультаце праблема заключаецца у тым, што дапамогу OAuth трэба стварыць вручную. У гэтым аспекце LM Studio не ўнікальная, адколі VS Code і Copilot CLI ад GitHub сталкнуцца з тымі ж обмежэннямі. Настройка трывае апошней час:

1. Ачынайце github.com/settings/developers, выберыце OAuth Apps і нажміце New OAuth App.
2. Уведзіце будзь-яе называнне і URL галоўнай стороніцы, адколькі ў гэтым случае яны не маюць значэння. Установіце Redirect URI на самэлькі http://127.0.0.1:33389/mcp-oauth-callback.
3. Нажміце Register application, а потым на наступной сторонцы — generate a new client secret. Зберагучы ID кліента і секрэт у безпечным месцы, адколькі секрэт паказваецца толькі аднажды.

Калі у вас ўжо ёсць оба значэння, настройкі будуць такімі:

{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "auth": {
        "CLIENT_ID": "<your Client ID>",
        "CLIENT_SECRET": "<your client secret>"
      }
    }
  }
}

Зберэжыце файл, увядзіце сервер, а пасля нажміце Authenticate, а потым Trust, and Open in Browser. Адкроюцца вікно браузера на сторанцы GitHub для OAuth. Калі будзе надана даступнасць за дапамою Authorize <username> у ніжней частцы сторанцы, токен будзе зберагацца так жа, як і для будзь-яго іншага сервера, падтрымванага OAuth.

Старанца схвалення на GitHub працуе толькі з можлівасцю схваліць або адрадзіць, без выбору дыячнасці. Болей тонкі кантроль знаходзіцца ў самам LM Studio. Адкройце панель Integrations і знайдзіце спіс Засобаў, які належыць серверу mcp/github. Кожны з адкрываецца засобаў паказаны самастойна, сярод іх create_pull_request, delete_file, push_files і merge_pull_request, плюс дзесяткі іншых; кожны з іх мае прапусканне і пераключач «Ask» або «Allow».

Эты сапіс заслуговае на адзін мінут. Знімітэ з пазначкі ўсё, чым модэль не должна касацца; delete_file і push_files — гэта явныя першыя варыянты, калі мета — толькі чытанне і стварэнне кантакту.

У пасляпэльнай скрыншоце гэтай групы get_me быў вызваны адназначы і search_repositories — два разы ў жывым GitHub, пры чым была выканана правільная фільтрацыя па датах стварэння і адчынення. Інструменты толькі для чытання і сэрвысы самай модэль застаюцца пазначанымі, тады як разрушаючыя інструменты, такія як delete_file і push_files, — непазначанымі.

Канфігурацыя 3: кантроль браузера

Гэтая канфігурацыя дае локальнай модэль можлівасць аналізаваць жывую веб-сторанку, а не толькі спадзявацца на даны з адучэння. Сервер Playwright MCP запускае рэальны браузер і падае структураваны тэкст сторанкі заместо скрыншотаў, што дазволяе нават невялікай локальнай модэль надзеясціва навігаваць і выкарыстоўваць тэкст.

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--headless"
      ]
    }
  }
}

Два моменты, якія трэба ведаць пры ўставлэнні. За замовчанням сервер ачынае відкрываемае вікно браузера, якае называецца рэжымам з відображэнням, а пазначка --headless у налашчэннях выключае гэта. На апаратзе з дыскрэйном можна стачыцца без гэтай пазначкі, каб бачыць усе клікі модэлю ў рэальны час, што стае корыстным, калі селектар не працуе. Тут таксама паслужыць Node 18 або новейшая версія, як і у налашчэннях 1; пад час першага запуску можа быць пропанована загрузка бінарных файлоў браузера праз npx playwright install, калі ўхоўваюцца.

Просты тэст — папросіць модэль ачысці галоўную старонку Hacker News і падсумаваць пяць найважлівейшых статэйкаў. Ён запускае browser_navigate, а потым чытае дрэво доступнасці сторанкі для знаходжэння заглаваў і спыянняў, без вікорыстоўвання модэляў для розпазнавання візуальных дадзеных чы аналізу скрыншотаў у цыкле.

Автаматызацыя прыгледача, якая ўсвядома запэчатваецца проты фінгерпрынтавання, для даследжэнняў або працы у стылі OSINT, — гэта іншая задача. Серверы на базе Camoufox, такія як Camofox-MCP, падходзяць для гэтага. Гэтае настройканне ўтварае стандартную базу.

Усуненне проблем

Гэтыя ўскладнення ёсць найбольш верагоднымі, прыблізна ад найчастэйшых да менш частых.

Мадэль ніколі не выканае вызовы інструментам. Звычная прычына — загрузка базовай або допаможнай мадэлі там, дзе павінна быць мадэль, настроўаная для выканання інструкцый чытаў або дзеянняў у чаце. Прачытайце інфармацыю пра мадэль, і калі там не згадваецца вікорыстанне інструментам чы вызовы функцый, заменіце ёю. Qwen 3.5 9B — хорашы выбар для локальнага вікорыстання з метой вызову інструментам.

Пасавер не прабывае адзначаны ў боковай панелі чату пасля змены mcp.json. Спачатку перазаваноўціце спіс пасавероў з вікна «Програма», а як гэта не дапаможа, цалкам перазапусціце LM Studio. Файлы, якія зменяюцца безпасуль на дыску, а не ў внутрашнім рэдагувальніку прыложэння, часта вымагаюць такога перазапуску.

Паспялелы JSON для вызову інструмента або выдуманыя параметры. Зменшыце значэння тэмпературы працы, адколькі вызов інструмента ўваходзіць у тыя некалькі задач, дзе крэатыўныі рэжым пагубна вплывае на ўжоць. Таксама пераканайцеся, што дужынка кантэксту становіць прынямна 4096 токенав. Схемы інструментаў швайна спрацоўваюць кантэкст, а больш за ўсе — вялікі набор інструментаў GitHub; малая кантэкстная плошча часта ёсць скрытым адказам за непূরныя вызывы.

Рэзультат

Рэзультат — тры серверы, жадных вызоў API і локальны модэль, які можа чытаць файлавую сістэму, працаваць з рэальным рэпазітарыем GitHub і кераваць жывым прыгледачам; кожны вызов перакантролюецца і будзе затверджаны ў дыялоговых вікнах паўтарэння LM Studio, і ніхто з іх не працуе без нагляду.

Сама по сабе гэта ўжо корыстны локальны агент, і ён становіць базу для цэлага автонамнага рабочага працэсу. Розумны наступны крок — з’едыніць тры серверы ў адну ціклічную структуру агента, замест таго каб кераваць кожным окрэмымі запросамі.

Дакументацыя

Дасяжыні LM Studio пра выкарыстанне сервераў MCP і інтэграцыю MCP з OAuth апісваюць фарматы command, args, url і auth, якія вікорыстоўваюцца ў всіх прыкладах. Рэпазітарый сервера MCP на GitHub і дасяжыні GitHub пра наладку охопляюць Config 2, а фармат файловай сістэмы modelcontextprotocol, які ўтварае офіцыйны сервер, — Config 1; рэпазітарый microsoft/playwright-mcp дастаёць інфармацыю пра стандартную працэздатнась і пазнакі для Config 3.