lens-mcp in družina MCP strežnikov, kaljenih z AI agenti
Pravkar smo izdali lens-mcp — deterministične zemljevide za navigacijo po kodi in dokumentaciji. Kaj počne, zakaj smo zanj združili dva strežnika in kateri družini treh strežnikov se pridružuje.
Pravkar smo izdali lens-mcp — strežnik Model Context Protocol, ki AI-agentu ponudi deterministične zemljevide za navigacijo po kodi in dokumentaciji v markdownu. To je že tretji odprtokodni MCP strežnik iz Segentic Lab in pravi trenutek, da spregovorimo o vseh treh — ker stojijo na eni sami ideji.
Kaj lens počne
Agent, ki pristane v neznanem repozitoriju, žetone zapravlja vsakič enako: ls, grep, nato bere cele datoteke, da najde tisto eno funkcijo ali pravi dokument. lens namesto ozemlja izroči zemljevid.
mapv enem klicu vrne celotno površino projekta — zgradbo vsake kodne datoteke in oris vsakega dokumenta.function_bodyvrne izvorno kodo ene funkcije — pogosto ~99 % manj konteksta kot branje datoteke, v kateri se nahaja.headingstori isto za en razdelek dokumenta.- Skupno 12 orodij, čez TypeScript / JavaScript / Python (tree-sitter) in markdown.
Dvoje ga naredi za več kot le priročnost. Prvič, je determinističen — pravo razčlenjevanje (parsing), ne model, ki povzema, zato je zemljevid vsakič enak. Drugič, je pošten: sintaktične napake se pokažejo, namesto da izginejo, vsak seznam je omejen ob navedbi resničnega skupnega števila, sama pogodba pa je zapisana v opisih orodij — lens je zemljevid za navigacijo; z njim se locirajte, nato preberite pravo izvorno kodo, preden sodite ali spreminjate. Podpis ni telo.
Zakaj smo zanj združili dva strežnika
lens se ni začel kot en strežnik. Imeli smo codelens (koda) in docslens (dokumentacija) — dva strežnika iz istega obdobja, iste oblike nad različnimi tipi datotek. To je davek: dva izdajna cevovoda, dva seznama v imeniku, dva nabora prijav (issues) za nekaj, kar je v resnici eno samo opravilo. Zato smo ju združili. Isti, v boju preizkušeni razčlenjevalni pogoni, zdaj en strežnik z enotnim map, ki zaobjame oboje, in en sam cevovod. Manj, a ostrejših orodij namesto dveh skorajšnjih dvojnikov. codelens je arhiviran s preusmeritvijo; lens nosi vse, kar je počel on, in povrhu še dokumentacijo.
Družina, ki se ji pridružuje
lens je eden od treh MCP strežnikov, ki jih gradimo in vzdržujemo, vsak za drug del tega, kar agent potrebuje:
- periscope-mcp — QA spletnih aplikacij. 74 orodij Playwright, ki testirajo spletne strani in aplikacije za prijavo ter vračajo trde sodbe —
assert_conditiondapassed: true/false, ne posnetka zaslona, v katerega je treba mežikati. Meri pravi Interaction-to-Next-Paint, presoja dostopnost / SEO / pripravljenost na iskanje z agenti in označi tihe prazne teke, namesto da bi hlinil uspeh. - lens-mcp — navigacija po kodi in dokumentaciji. Zemljevid od zgoraj.
- glovebox-mcp — peskovniška raba računalnika. Agentu da pravo namizje za upravljanje — miško, tipkovnico, vid — zapečateno v ugnezdenem oknu X11, da nikoli ne more poseči v vaš pravi zaslon. 18 orodij, več oken aplikacij hkrati.
Dva od njih (periscope, lens) imata isti nagon: agentu daj zemljevid, ne ozemlja — interaktivno površino strani, površino kode-in-dokumentacije projekta. glovebox je dopolnilo — kadar zemljevida ni mogoče dobiti, agentu raje ponudi varne rokavice.
Ena metoda za vsemi tremi
Strežniki so videti različni; način, kako so narejeni, je enak. Vsakega gradimo z AI-agenti in ga kalimo tako, da vanj usmerimo drugega agenta ob resničnem delu. Vsaka ovira, na katero ta agent naleti, postane prijava, vsaka prijava pa popravek z regresijskim testom. periscope jih je tako zaprl 20 in zdaj brez zapletov opravi celoten pregled strani za prijavo; lens prihaja s 138 testi; vsak strežnik vrača napake, ki poimenujejo popravek, omejuje vsak izpis in ohranja svojo dokumentacijo skladno z vedenjem.
To je rdeča nit, o kateri smo pisali tukaj: prompt opisuje vedenje; programska oprema ga zagotavlja. Znanje, ki ga ta orodja utelešajo — kako razčleniti puščice razrednih polj v datoteki TSX, zakaj mora seja brskalnika z glavo (headed) podedovati prijavo, da zahtevka pojavnega okna v prvi milisekundi ni mogoče ujeti — ne izhlapi ob koncu seje. Je v kodi, vsiljeno, ob vsakem teku.
Kje jih dobite
Vsi trije so odprtokodni in delujejo s katerim koli MCP-odjemalcem — Claude Code, Cursor, Codex ali vašim lastnim agentom. Vsak se namesti v eni vrstici in vključuje AGENTS.md, ki ga prilepite v sistemski prompt svojega agenta:
git clone https://github.com/segentic-lab/lens-mcp && cd lens-mcp && ./install.sh
Več na lab.segentic.dev. Če vam je kateri koristen, ⭐ na repozitoriju resnično pomaga.