shadcn-ui-mcp-server: ο βοηθός διαβάζει τον κώδικα των components, δεν τον μαντεύει
Ο shadcn-ui-mcp-server είναι διακομιστής MCP που δίνει στον βοηθό τον πραγματικό πηγαίο κώδικα των components του shadcn/ui v4, σε React, Svelte, Vue και React Native. Αντί να μαντεύει props και variants, τα διαβάζει από την πηγή. Δέκα εργαλεία, χωρίς κλειδί, μηδέν χρήμα. Τον ζυγίσαμε στο μηχάνημά μας: 972 tokens σε κάθε συνεδρία, 40 MB στον δίσκο, 83 MB μνήμη. Και μία επιφύλαξη που δεν την κρύβουμε: δύο ανεξάρτητοι έλεγχοι ασφαλείας διαφωνούν.

Τι κάνει
Έχεις δει τον βοηθό να σου φτιάχνει κουμπί με λάθος ύψος, λάθος χρώμα, λάθος variant. Δεν το κάνει από αδιαφορία. Το γράφει από τη μνήμη του, και η μνήμη του δεν ξέρει πώς είναι σήμερα το component. Ο shadcn-ui-mcp-server υπάρχει για να του δώσει τα μάτια.
Δύο λέξεις πρώτα, γιατί χωρίς αυτές το υπόλοιπο δεν βγάζει νόημα. Το MCP είναι ένα πρωτόκολλο που επιτρέπει σε έναν βοηθό τεχνητής νοημοσύνης να συνδέεται με εξωτερικά εργαλεία μέσα στην κουβέντα· ο βοηθός δεν τα ξέρει από πριν, τα ανακαλύπτει στην αρχή της συνεδρίας. Το shadcn/ui είναι μια συλλογή έτοιμων components για ιστοσελίδες — κουμπιά, διάλογοι, πίνακες — με τη διαφορά ότι δεν τα εγκαθιστάς ως βιβλιοθήκη: σου αντιγράφει τον κώδικα μέσα στο δικό σου project.
Αυτός ο διακομιστής, λοιπόν, δεν εγκαθιστά τίποτα. Διαβάζει. Πάει στα αποθετήρια του shadcn/ui v4 και φέρνει στον βοηθό τον πηγαίο κώδικα, τα παραδείγματα χρήσης, τα blocks (έτοιμες συνθέσεις σελίδων, όπως ταμπλό και φόρμες) και τα metadata. Δουλεύει με τέσσερα οικοσυστήματα: το shadcn/ui για React, το shadcn-svelte, το shadcn-vue και το react-native-reusables, τα οποία επιλέγεις με τη σημαία --framework (αποθετήριο).
Δεν είναι το ίδιο εργαλείο με τον επίσημο MCP server του shadcn, που μιλάει με registries και σου φτιάχνει εντολή εγκατάστασης. Εκείνος σου λέει «πρόσθεσε αυτό»· αυτός σου ανοίγει τον κώδικα και στον δείχνει. Είναι συμπληρωματικοί, όχι ανταγωνιστές, και το λέμε γιατί εύκολα μπερδεύονται.
Δέκα εργαλεία εκθέτει, και τα είδα να δηλώνονται στη δοκιμή: get_component, get_component_demo, list_components, get_component_metadata, get_directory_structure, get_block, list_blocks, apply_theme, list_themes, get_theme. Τα εννέα είναι ανάγνωση. Το δέκατο γράφει, και θα το πούμε στην ώρα του.
Τα τρία τελευταία, τα list_themes, get_theme και apply_theme, δεν αφορούν components αλλά θέματα. Το tweakcn είναι μια συλλογή έτοιμων χρωματικών θεμάτων, και ο διακομιστής τα κατεβάζει και μπορεί να εφαρμόσει ένα στο project σου. Είναι το μόνο σημείο του εργαλείου που αλλάζει κάτι, και γι’ αυτό το ξεχωρίζουμε από τα υπόλοιπα εννέα.
Τι δεν κάνει
Δεν κάνει εγκατάσταση ή τροποποίηση components στο project σου. Αυτό που δεν κάνει είναι εγκατάσταση ή τροποποίηση components στο project σου. Από τα δέκα endpoints, τα εννέα μόνο διαβάζουν. Μην του ζητήσεις «πρόσθεσε αυτό το component» ή «τρέξε npm install» — δεν το κάνει. Δεν είναι ο επίσημος MCP server που δημιουργεί εντολή εγκατάστασης. Το μοναδικό πράγμα που αλλάζει αρχεία είναι το apply_theme και πρέπει να το αντιμετωπίσεις ως ξεχωριστο βήμα.
Δεν διαβάζει αυτόματα τα τοπικά σου αρχεία ή τις δικές σου προσαρμογές αν δεν του τα δείξεις. Διαβάζει τα επίσημα αποθετήρια shadcn/ui (και τα οικοσυστήματα που υποστηρίζει). Δεν τρέχει build, δεν εκτελεί tests, ούτε επιλύει runtime σφάλματα, conflits CSS ή προβλήματα import/peer dependencies. Δεν θα διορθώσει αυτομάτως το app σου όταν λείπουν πακέτα ή όταν οι ονομασίες props έχουν αλλάξει τοπικά.
Η παγίδα είναι να το θεωρήσεις «όλο-σε-ένα» εργαλείο ανάπτυξης. Ζητάς από τον βοηθό τον πραγματικό πηγαίο κώδικα — και αυτό παίρνεις — αλλά μετά εσύ πρέπει να τον ενσωματώσεις, να εγκαταστήσεις εξαρτήσεις και να δοκιμάσεις το αποτέλεσμα στο περιβάλλον σου. Δοκιμάσαμε και το επιβεβαιώσαμε: βλέπει, δεν παρεμβαίνει.
Για ποιον είναι
Για όποιον φτιάχνει interfaces με shadcn/ui και βαριέται να διορθώνει τον βοηθό. Ο ερασιτέχνης που έμαθε τη λέξη «πράκτορας» την περασμένη βδομάδα θα καταλάβει το όφελος από την πρώτη ερώτηση: αντί να του δώσει ο βοηθός ένα κουμπί από τη φαντασία του, του δίνει το κουμπί που είναι σήμερα στο επίσημο αποθετήριο, με όλα τα variants του. Ο επαγγελματίας κερδίζει κάτι πιο συγκεκριμένο: σταματά να διορθώνει props και ονόματα που άλλαξαν.
Λάμπει όταν δουλεύεις React και χρειάζεσαι σύνθετα blocks, ή όταν το project σου έχει περάσει σε Svelte, Vue ή React Native και το ίδιο σου φτιάχνει component για όλα. Και λάμπει όταν δεν θέλεις να στήσεις τίποτα — ούτε λογαριασμό, ούτε κλειδί.
Δεν είναι για σένα αν δεν δουλεύεις με shadcn/ui. Ο διακομιστής δεν έχει άλλη ύλη. Και δεν είναι για σένα αν θέλεις να εγκαταστήσεις component με μία εντολή από τον βοηθό· αυτό το κάνει ο επίσημος MCP server του shadcn, όχι αυτός.
Εγκατάσταση
Θέλεις Node 20 ή νεότερο· το δηλώνει το πεδίο engines του πακέτου (η εικόνα Docker, από την άλλη, χρησιμοποιεί Node 22). Το npx έρχεται μαζί με το Node, οπότε δεν εγκαθιστάς τίποτα χειροκίνητα.
Λες στον πελάτη σου να τρέξει τον διακομιστή, κάνεις επανεκκίνηση, και ρωτάς. Δεν κατεβάζεις αρχείο, δεν ανοίγεις κλειδί. Το npx κατεβάζει το πακέτο την πρώτη φορά — στη μέτρησή μας, 40 MB σε 4.274 αρχεία.
Η σημαία -y λέει στο npx να μην περιμένει επιβεβαίωση. Χωρίς κλειδί GitHub έχεις 60 αιτήματα την ώρα· με ένα προσωπικό κλειδί GitHub χωρίς δικαιώματα, 5.000 (αποθετήριο). Χωρίς κλειδί, η δοκιμή μας δούλεψε κανονικά.
Θέλεις άλλο οικοσύστημα, αλλάζεις μία σημαία: για Svelte --framework svelte, για Vue --framework vue, για React Native --framework react-native. Και στο React, αν προτιμάς τη βιβλιοθήκη primitives Base αντί για τη Radix, προσθέτεις --ui-library base. Είναι ισχυρισμοί κατασκευαστή, από την τεκμηρίωση του αποθετηρίου· δεν έτρεξα καθένα ξεχωριστά.
Χρήση σε κάθε LLM
Εδώ ο διακομιστής είναι MCP, άρα μιλάς με το σχήμα του: μία ρύθμιση, όπου δηλώνεις το εκτελέσιμο και τα ορίσματά του. Το γενικό σχήμα είναι το ίδιο παντού — ένα αντικείμενο mcpServers με ένα κλειδί, μέσα του command ίσο με npx και args ίσο με -y και @jpisnice/shadcn-ui-mcp-server. Αυτό που αλλάζει από πελάτη σε πελάτη είναι το αρχείο και η μορφή. Δεν οδήγησα συνεδρία μέσα σε κάποιον από αυτούς· τα βήματα είναι τεκμηρίωση, εκτός από όπου το λέω ρητά.
Claude Code
Το Claude Code έχει δική του εντολή, και είναι το πιο καθαρό μονοπάτι:
claude mcp add shadcn-ui -- npx -y @jpisnice/shadcn-ui-mcp-server
Μετά κάνεις επανεκκίνηση και ελέγχεις με claude mcp list, ή μέσα στη συνεδρία με /mcp. Περιμένεις τη γραμμή shadcn-ui: Connected. Αν δεν τη δεις, τις περισσότερες φορές φταίει ότι δεν έγινε επανεκκίνηση.
Codex CLI
Το Codex δεν έχει βοηθητική εντολή· η ρύθμιση μπαίνει με το χέρι στο ~/.codex/config.toml. Προσθέτεις μία ενότητα mcp_servers.shadcn_ui, όπου δηλώνεις command = "npx" και args = ["-y", "@jpisnice/shadcn-ui-mcp-server"]. Είναι η ίδια ρύθμιση, σε μορφή TOML αντί για JSON. Αυτό το μονοπάτι δεν το έτρεξα ως το τέλος γιατί δεν είχα Codex να το δοκιμάσω.
Cursor
Το Cursor διαβάζει το .cursor/mcp.json στη ρίζα του project, ή το ~/.cursor/mcp.json για όλα τα project. Γράφεις μέσα το αντικείμενο mcpServers με τον server, και μετά — αυτό το βήμα δεν το παραλείπεις — ανοίγεις τις ρυθμίσεις του Cursor και ενεργοποιείς τον server. Το Cursor δεν ξεκινά τους servers επειδή απλώς υπάρχει το αρχείο. Όταν ενεργοποιηθεί, βλέπεις πράσινη κουκκίδα δίπλα στο όνομα και τη λίστα των εργαλείων.
Μία σημείωση για όλους: μετά τη ρύθμιση ζητάς κάτι σαν «δώσε μου τον πηγαίο κώδικα του button από το shadcn/ui v4». Αν δεν απαντήσει, οι δύο συνηθισμένες αιτίες είναι η επανεκκίνηση που ξεχάστηκε και η ρύθμιση γραμμένη σε λάθος αρχείο.
Πού κερδίζει, πού χάνει
Κερδίζει στο κεντρικό: ο βοηθός βλέπει τον πραγματικό κώδικα, όχι την ανάμνησή του. Το get_component button έφερε 2.546 χαρακτήρες με όλα τα variants — default, destructive, outline, secondary, ghost, link. Αυτό είναι το τέλος της διόρθωσης props που άλλαξαν.
Κερδίζει στο εύρος. Τέσσερα οικοσυστήματα με ένα εργαλείο, και δύο βιβλιοθήκες primitives για το React (Radix και Base). Κερδίζει στην τιμή: μηδέν λογαριασμός, μηδέν κλειδί, μηδέν συνδρομή. Και κερδίζει στο ότι είναι γρήγορο — εκκίνηση 1,6 δευτερόλεπτα στη μέτρησή μας.
Τώρα πού χάνει.
Πρώτο, το apply_theme γράφει. Από τα δέκα εργαλεία, τα εννέα διαβάζουν· αυτό αλλάζει θέμα στο project σου, από τα έτοιμα presets του tweakcn. Δεν είναι κακό — είναι το μόνο εργαλείο που αφήνει σημάδι. Άρα το τρέχεις σε project, όχι στο αντίγραφο του πελάτη σου, και κάνεις commit πριν.
Δεύτερο, θέλει δίκτυο. Κάθε component το φέρνει ζωντανά από το GitHub. Χωρίς σύνδεση δεν έχει ύλη, και χωρίς κλειδί GitHub το όριο είναι 60 αιτήματα την ώρα — αρκετό για δοκιμή, λίγο για βαριά δουλειά.
Τρίτο, δεν συμπιέζει. Κάθε component μπαίνει στο πλαίσιο ολόκληρο. Το button είναι 2.546 χαρακτήρες· ένα block είναι πολύ μεγαλύτερο. Αν ο βοηθός τραβήξει τρία blocks για να απαντήσει σε μια ερώτηση, τα πληρώνεις όλα.
Και η επιφύλαξη ασφάλειας, που δεν την κρύβουμε. Δύο ανεξάρτητοι έλεγχοι διαφωνούν, και τις δύο φορές κοιτάζουν τον ίδιο κώδικα. Το M8ven δίνει A, 98/100, με απόφανση «ο κώδικας καθαρός, ισχυρή υιοθέτηση», δέκα εργαλεία μετρημένα, και κανένα μυστικό στον κώδικα. Το ModelsAtlas το μπλοκάρει με D, 69/100, και καταγράφει δύο ευρήματα υψηλής σοβαρότητας. Και τα δύο είναι το ίδιο πράγμα: new Function που εκτελεί κείμενο ως κώδικα, στις γραμμές 92 και 118 του src/tools/tweakcn/fetch-presets.ts. Είναι ο κώδικας που διαβάζει τα presets του θέματος, και η τεχνική είναι γνωστό μοτίβο έγχυσης κώδικα. Ο ένας έλεγχος το προσπερνά, ο άλλος το βαθμολογεί ως αποτυχία. Εμείς δεν πήραμε θέση: λέμε τι βρήκε ο καθένας, επειδή ο αναγνώστης πρέπει να το ξέρει πριν το βάλει σε δουλειά πελάτη. Ο κώδικας ζει σε ένα πρόσωπο, με άδεια MIT.
Δοκιμή
Ό,τι ακολουθεί τρέξαμε σε Windows 11, σε Dell Inspiron 3576, χωρίς κάρτα γραφικών. Δεν έστησα συνεδρία πράκτορα μέσα σε Claude Code, Codex ή Cursor· ό,τι δοκιμάστηκε, δοκιμάστηκε στο κέλυφος και μέσα από πρωτόκολλο.
Πρώτα η έκδοση. Η εντολή npx -y @jpisnice/shadcn-ui-mcp-server --version τύπωσε 3.0.0, όπως δηλώνει το npm.
Μετά το πιο πειστικό κομμάτι, που δεν το δίνουν τα περισσότερα άρθρα: άνοιξα τον διακομιστή με το χέρι, μιλώντας του JSON-RPC πάνω από την πρότυπη είσοδο. Στο initialize δήλωσε serverInfo με όνομα shadcn-ui-mcp-server και έκδοση 3.0.0, και συμφώνησε στο πρωτόκολλο MCP της 28ης Ιουλίου 2026. Το tools/list γύρισε 10 εργαλεία: τα get_component, get_component_demo, list_components, get_component_metadata, get_directory_structure, get_block, list_blocks, apply_theme, list_themes, get_theme.
Και μετά μια πραγματική κλήση, χωρίς κλειδί GitHub. Το get_component button γύρισε 2.546 χαρακτήρες πηγαίου κώδικα, με όλα τα variants μέσα: default, destructive, outline, secondary, ghost, link. Το list_components γύρισε 61 components. Χρόνος εκκίνησης: 1,6 δευτερόλεπτα. Δηλαδή η υπόσχεση ισχύει: ο βοηθός δεν μαντεύει, διαβάζει.
Τι δεν έτρεξα, και το λέω καθαρά. Δεν δοκίμασα το apply_theme σε ζωντανό project, για να μην αλλάξω θέμα σε δικό μας· ό,τι γράφω γι’ αυτό είναι από την τεκμηρίωση και από τη δήλωση των εργαλείων. Δεν πέρασα από Codex. Και τα νούμερα του αποθετηρίου — 3.069 αστέρια, 315 forks, 7 ανοιχτά issues, άδεια MIT, τελευταίο push στις 3 Οκτωβρίου 2026 — τα διάβασε η έρευνα, μαζί με τις 16.454 λήψεις του npm για τον μήνα 23 Σεπτεμβρίου με 22 Οκτωβρίου 2026 και τις δύο σελίδες ελέγχου ασφαλείας που είδαμε πιο πάνω.
Τι κοστίζει
Το μοντέλο. Δικό μας νούμερο: το σχήμα των δέκα εργαλείων είναι 3.890 χαρακτήρες, περίπου 972 tokens, και φορτώνεται σε κάθε συνεδρία που ο server είναι ανοιχτός — ακόμα κι όταν δεν ζητήσεις component. Είναι φόρος, όχι χρέωση: τον πληρώνεις μία φορά ανά συνεδρία, στην αρχή.
Το μηχάνημα. Δικό μας νούμερο: 40 MB στον δίσκο σε 4.274 αρχεία στο πρώτο κατέβασμα, και ~83 MB μνήμη (RSS) με μία διεργασία node εν κινήσει. Ισχυρισμός κατασκευαστή: θέλει Node 20+, όπως το δηλώνει το πεδίο engines.
Σε χρήμα, μηδέν. Ούτε κλειδί, ούτε συνδρομή, ούτε κάρτα. Το προαιρετικό κλειδί GitHub δεν κοστίζει τίποτα· απλώς ανεβάζει το όριο από 60 σε 5.000 αιτήματα την ώρα — ισχυρισμός κατασκευαστή, από την τεκμηρίωση του αποθετηρίου.
Και μία δική μας παρατήρηση, από την έρευνα: η σελίδα του M8ven που μας έδωσε το 98/100 είχε αποθηκευτεί στις 6 Οκτωβρίου 2026, και ο ίδιος ο έλεγχος τη σημαδεύει ως πολύ παλιά για να εμφανιστεί. Ο βαθμός ισχύει για ό,τι είδε τότε, όχι απαραίτητα για τον κώδικα που θα κατεβάσεις σήμερα.
Ετυμηγορία
Score: 8.2/10.
Ο shadcn-ui-mcp-server λύνει ένα πρόβλημα που το νιώθεις πριν το ονομάσεις: ο βοηθός σου φτιάχνει components που δεν μοιάζουν με τα σημερινά. Το λύνει δίνοντας στον πράκτορα τον πραγματικό πηγαίο κώδικα, δωρεάν, χωρίς κλειδί, με δέκα καθαρά ονόματα. Το get_component button έφερε 2.546 χαρακτήρες με έξι variants· το list_components, 61 components· η εκκίνηση, 1,6 δευτερόλεπτα. Και το --version λέει 3.0.0, όπως στο npm.
Τους δύο βαθμούς τους χάνει σε τρία σημεία. Το apply_theme γράφει, άρα θέλει προσοχή. Θέλει δίκτυο και, χωρίς κλειδί, έχει χαμηλό όριο. Και δεν συμπιέζει: κάθε component μπαίνει ολόκληρο στο πλαίσιο. Πάνω από όλα αυτά, η επιφύλαξη ασφάλειας: M8ven A/98, ModelsAtlas D/69, με δύο ευρήματα έγχυσης κώδικα που ο ένας τα προσπερνά και ο άλλος τα βαθμολογεί ως αποτυχία. Δεν παίρνουμε θέση· το λέμε, και το αφήνουμε στην κρίση σου.
Αν δουλεύεις shadcn/ui με πράκτορα, δοκίμασέ το σε ένα project δικό σου, όχι σε project πελάτη, και διάβασε πρώτα τη σελίδα του ModelsAtlas.
Δείτε επίσης
Τρία ακόμη από την ίδια κατηγορία:
- Lighthouse: ο ελεγκτής που ανοίγει τη σελίδα σου και σου λέει τι χαλάει
- @shadcn/lint: ο linter που διορθώνει τον πράκτορα, δεν τον μαλώνει
- Project Wallace: αεροφωτογράφιση της σχεδιαστικής συνέπειας
Πηγές: αποθετήριο https://github.com/Jpisnice/shadcn-ui-mcp-server · πακέτο npm https://www.npmjs.com/package/@jpisnice/shadcn-ui-mcp-server · εκδόσεις https://github.com/Jpisnice/shadcn-ui-mcp-server/releases · έλεγχος M8ven https://m8ven.ai/check · έλεγχος ModelsAtlas https://modelsatlas.com/mcp/jpisnice/shadcn-ui-mcp-server/ · shadcn/ui https://ui.shadcn.com/