> Elemzés a modelcontextprotocol/servers repozól: hét referenciaszerver, mit tanít mindegyik, a mögöttes SDK-verziók, és miért nem kerülhet egyik sem éles rendszerbe.
>
> Web page: https://balazscsorba.com/hu/blog/mcp-reference-servers · Language: Magyar · Also available in: [English](https://balazscsorba.com/blog/mcp-reference-servers.md) · [Deutsch](https://balazscsorba.com/de/blog/mcp-reference-servers.md)
> Author: Balázs Csorba · Published: 2026-09-25 · Keywords: mcp reference servers, modelcontextprotocol servers github, write an mcp server, mcp server examples, mcp server sdk, mcp server security

[Blog](https://balazscsorba.com/hu/blog)/MI-ágensek

# MCP-referenciaszerverek: mit mutatnak be és mit hagynak ki

Elemzés a modelcontextprotocol/servers repozól: hét referenciaszerver, mit tanít mindegyik, a mögöttes SDK-verziók, és miért nem kerülhet egyik sem éles rendszerbe.

[Balázs Csorba](https://balazscsorba.com/hu/about)·2026\. szeptember 25.·9 perc olvasás

-   MCP
-   Reference servers
-   Tool protocol
-   Server SDKs

![Hét egyforma kis doboz sorban egy polcon, előtte zárt sorompó.](https://balazscsorba.com/images/blog/mcp-reference-servers/cover.webp?v=3cbba272c8)

## A lényeg röviden

-   Hét referenciaszerver van a src/ mappában — négy TypeScript, három Python —, amelyeket a README maga is oktatási példának, nem termelési kódnak nevez.
-   A Pythonos szerverek továbbra is mcp >=1.29.0 és <2 követelményt támasztanak, miközben a Python SDK 2026. október 2-án már a 2.3.0-nál tart; aki lemásolja őket, az 1.x-es API-t tanulja.
-   A repository kifejezetten kizárja a sebezhetőségi bejelentéseket: a SECURITY.md a SDK repositorykba irányítja a találatokat.
-   A csomagokat CI-ből, OIDC trusted publishinggel és provenance igazolásokkal teszik közzé, registry-token nélkül.
-   A filesystem szerver útvonal-fehérlistája a gyűjtemény egyetlen homokozója, amelyet a kliens menet közben Roots-szal lecserélhet.

Ezen az oldalon

1.  [Mi ez](https://balazscsorba.com/#what-it-is)
2.  [A repository szerverenként](https://balazscsorba.com/#repository-layout)
3.  [Hogyan fut valójában egy szerver](https://balazscsorba.com/#how-it-works)
4.  [Első lépések](https://balazscsorba.com/#getting-started)
5.  [Biztonsági helyzet](https://balazscsorba.com/#security-posture)
6.  [Hol akad el](https://balazscsorba.com/#where-it-shingles)
7.  [Ítélet](https://balazscsorba.com/#verdict)
8.  [Források](https://balazscsorba.com/#sources)

Cikk meghallgatása

0:000:00

A modelcontextprotocol/servers a Model Context Protocol hivatkozógyűjteménye: hét kis szerver, amelyeket a MCP-irányító testület gondoz, és amelyek közül mindegyik a protokoll egy részét mutatja be, nem pedig egy feladatot csinál jól. Termékként olvasva oktatási anyag szokatlanul őszinte README-vel, és itt az a álláspont: olvassuk és futtassuk helyben, de soha ne telepítsük — a repository kifejezi, hogy a szerverek nem termelésre készültek, a biztonsági irányelve pedig elutasítja az ellenük beérkező sebezhetőségi bejelentéseket. Abban jó, hogy működő kódban mutatja meg, mit kell egy szervernek megvalósítania, a specifikáció íróitól.

A modelcontextprotocol.io specifikációja és a tíz hivatalos SDK között helyezkedik el, és nem versenyez a MCP Registryvel, ahol a tényleges használatra szánt szerverek vannak listázva. Itt semmi sem vált ki egy keresőindexet, böngésző-eszközt vagy jegykezelő-integrációt. A gyűjtemény egy korábbi, vegyes apró példányt váltott fel, amelyek többsége ma külön archív repositoryban fekszik, és továbbra is felbukkan régi útmutatókban.

## Mi ez

Egy npm workspace, benne hét csomag a `src/` mappában, npm-en `@modelcontextprotocol/server-*`, PyPI-n `mcp-server-*` néven kiadva. Négy szerver TypeScript, három Python, és mindegyik egy-egy protokollfunkciót különít el: hozzáférés-kezelést, promptokat és erőforrásokat, tudásgráfot, az önátírás eszközt, web-lekérést, repository-műveleteket, időzónákat.

-   Körülbelül 91 100 csillag és 11 800 fork 2026 októberének elején, 4 194 committal a main ágon.
-   Hét referenciaszerver a src/ mappában: everything, fetch, filesystem, git, memory, sequentialthinking és time.
-   Tizenhárom kivezetett szerver — GitHub, Slack, PostgreSQL, SQLite, Puppeteer és Brave Search köztük — a servers-archivedbe költözött; a Brave-ét maga a Brave tartja karban.
-   A README most a MCP Registryhez irányítja a szervereket keresőket, a repository pedig csak a referenciamegvalósításokat tartja.
-   Licenc: az új hozzájárulások Apache-2.0, a korábbi kód továbbra is MIT alatt, ahogy a LICENSE fájl leírja.
-   A szervercsomagok naptári verziók: 2026.8.31 a TypeScript, 2026.8.18 a Python csomagoknál.
-   A kiadás zárt CI-folyamatból, OIDC trusted publishinggel és provenance igazolással történik, a kiadási úton egyetlen registry-token sincs.

## A repository szerverenként

A szerkezet szándékosan lapos: szervernként egy mappa a `src/` alatt, egy gyökér package.json, amely őket npm workspace-ként fűzi össze, és néhány üzemeltetési dokumentum a legfelső szinten. Egy szervermappát lentolvasni a leggyorsabb módja a protokoll tanulásának, mert mindegyik egy ülésben áttekinthető.

Szerver

Nyelv

Mit mutat be

Kiadva

everything

TypeScript

Promptok, eszközök, erőforrások, mintavételezés, felhasználói megerősítés, haladás, naplózás és feladatok

@modelcontextprotocol/server-everything

fetch

Python

URL-lekérés, readability-kinyerés, markdown-konverzió, robots.txt

mcp-server-fetch

filesystem

TypeScript

Útvonal-fehérlista és könyvtár-vezérlés Rootson át

@modelcontextprotocol/server-filesystem

git

Python

Tizenkét repository-eszköz: status, diff, log, commit, branch, show

mcp-server-git

memory

TypeScript

Entitások, relációk és megfigyelések tudásgráfként

@modelcontextprotocol/server-memory

sequentialthinking

TypeScript

Egyetlen eszköz, amely a saját érvelése korábbi lépéseit átírja

@modelcontextprotocol/server-sequential-thinking

time

Python

get\_current\_time és convert\_time IANA-zónákban

mcp-server-time

A src/ mellett a gyökérben ott az ADDITIONAL.md a közösségi frameworkökhöz és kliensekhez, a RELEASING.md a csomagok regisztrációkba jutásáról, a SECURITY.md, a CLAUDE.md, a saját toolinghoz használt .mcp.json és egy scripts mappa. A everything szerver kivétel a lapos szerkezet alól: docs mappát cipel architektúra-, funkció- és kiterjesztési pontokkal, és inkább protokoll-konformitási rögzítő, mint sablon.

### SDK-k és nyelvi verziók

A README tíz hivatalos SDK-t sorol fel — C#, Go, Java, Kotlin, PHP, Python, Ruby, Rust, Swift és TypeScript —, és rögzíti, hogy a referenciaszerverek ezeken alapulnak. A gyakorlatban a TypeScript csomagok naprakészek, a Python csomagok pedig egy főverzióval lemaradva állnak, ezt a time szerver README-je egy mondatban le is írja.

Csomag

Verzió

Kiadva

Megkötés

@modelcontextprotocol/sdk, TypeScript

1.32.1

2026\. október 5.

A szervercsomagok ^1.x-ben rögzítik

mcp, Python

2.3.0

2026\. október 2.

A Pythonos szerverek <2-t kérnek

@modelcontextprotocol/server-memory

2026.8.31

2026\. augusztus 31.

@modelcontextprotocol/sdk ^1.30.0

mcp-server-git, fetch és time

2026.8.18

2026\. augusztus 18.

mcp >=1.29.0 és <2

A time szerver szókimondóan megadja az okot: az SDK 2.0 átnevezte az általa használt API-kat, a portolás pedig zajlik. Ez a hivatkozógyűjtemény őszinte ára — a példányok szorosan követik a specifikációt, a Python fele viszont kevésbé követi az SDK főverzióit. Aki ma Pythonos szervert másol, az 1.x-es API ellen írt, működő kódot olvas: tanulmányozásra jó, új munkára csapda.

## Hogyan fut valójában egy szerver

A stdio-szerverrel konfigurált kliens indításkor gyermekfolyamatként indítja el, és sorokkal elválasztott JSON-RPC-t beszél vele a stdin és stdout fölött. Nem hallgat semmilyen port. Az initialize kézfogáson mindkét fél bejelenti a képességeit: a szerver, milyen eszközöket, erőforrásokat és promptokat valósít meg, a kliens, elfogad-e roots-ot, mintavételezést és felhasználói megerősítést — ezután minden kérés, válasz vagy értesítés.

![How a reference server runs At the top a box holds the MCP client, such as Claude Desktop, an IDE or an agent. A solid arrow labelled initialize and then JSON-RPC over stdio points down to a wide box for the reference server, a child process started from an npm or PyPI package. A dashed arrow returns from the server to the client, labelled roots and list_changed, because the client supplies the directory allowlist. Three boxes hang below the server: tools, which the model calls; resources, which the application reads at a URI; and prompts, which the user picks. A band at the bottom states that the process runs with the privileges of the user who started it and that the allowlist is a path check rather than a sandbox.](https://balazscsorba.com/images/blog/mcp-reference-servers/diagram-15.webp?v=d34f25a795)

A kezdéskori képesség-tárgyalás dönti el, mit kérhet egymástól a két fél; a három primitive az, amit a modell és az alkalmazás ténylegesen lát.

A három primitive nem felcserélhető. Az eszközt a modell hívja meg, az erőforrás URI-n érhető el az alkalmazás vagy a felhasználó számára, a prompt pedig olyan sablon, amelyet a felhasználó választ. A everything szerver mindhármat megvalósítja, plusz mintavételezést, felhasználói megerősítést, haladásjelzést, strukturált eszközkimenetet és az újabb feladat-kiterjesztést — ezért ez az egy mappa érdemes elolvasni, ha egy protokollfunkció nem világos.

## Első lépések

Semmit sem kell lefordítani. A szerver egy csomag az npm-en vagy a PyPI-n, és az alábbi konfiguráció maga a teljes telepítés: a kliens futtatja a parancsot, a parancs a stdout-on válaszol, a modell pedig megkapja az eszközlistát.

```
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "/path/to/repo"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}
```

Sajátot írni alig nehezebb. A TypeScript SDK egy szerverobjektust ad `registerTool`, `registerResource` és `registerPrompt` függvényekkel, plusz egy transzportot. Az alábbi snippet egy teljes szerver egyetlen eszközzel, formája megegyezik a filesystem és a memory példányokéval.

```
import { readFile } from "node:fs/promises";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "wordcount", version: "0.1.0" });

server.registerTool(
  "count_words",
  {
    title: "Count words",
    description: "Count the words in a UTF-8 text file",
    inputSchema: { path: z.string() },
  },
  async ({ path }) => {
    const words = (await readFile(path, "utf8")).split(/\s+/).filter(Boolean).length;
    return { content: [{ type: "text", text: String(words) }] };
  },
);

await server.connect(new StdioServerTransport());
```

**A verziót tűzzük ki, mielőtt bízunk benne**

Minden dokumentált példa `npx -y` vagy `uvx` használata, amely minden induláskor a legfrissebb verziót tölti le: a futó kód azt a verziót jelenti, amelyet a registry aznap kiszolgált. Tűzzük ki a verziót, olvassuk el a changelogot frissítéskor, és ne feledjük, hogy a stdio-szerver a saját felhasználónkként fut, azzal a hozzáféréssel, amelyet a fehérlista enged. Windowson ugyanez a parancs elé `cmd /c npx` kell.

## Biztonsági helyzet

A gyűjtemény szokatlanul világosan leírja, mi nem ő. A README figyelmeztető szakasza szerint a szerverek a funkciókat és az SDK-használatot mutatják be, a fejlesztőknek a saját biztonsági követelményeiket kell felmérniük, a szerverek pedig nem termelésre készültek. A SECURITY.md ezután rögzíti, hogy erre a repositoryra egyáltalán nem fogadnak el sebezhetőségi bejelentést — ez a legvilágosabb jelzés a szándékolt státuszról: az SDK-kat támogatják, a példányokat nem.

-   Minden szerver helyi gyermekfolyamat az őt indító felhasználó jogain, így a modell eszközhívásai fájl-, hálózati- és repository-műveletekké válnak abban a fiókban.
-   A filesystem szerver az egyetlen hozzáférés-kezeléssel: könyvtár-fehérlista parancssori argumentumokból, vagy menet közben a kliens Roots-szal cseréli le — az útvonal-ellenőrzés pedig nem homokozó.
-   A fetch szerver markdownra alakítja az oldalakat, betartja a robots.txt-t, és testre szabható user-agentet és proxyt ad; ennyi az egész gyűjtemény kimenő hálózati higiéniája.
-   A memory helyi JSON-fájlba írja a tudásgráfot hitelesítés nélkül, a git pedig a megadott repositoryútvonalba ír; egyik sincs hálózatra szánva.
-   A kiadás kézi workflow-dispatch egy követelményes Reviewerrel védett GitHub-környezetbe, npm-re és PyPI-re provenance igazolással, registry-token nélkül.

**Mielőtt szerver valódi fiókhoz ér**

Előbb olvassuk el [az MCP-szerver biztonsági ellenőrzőlistáját](https://balazscsorba.com/hu/blog/mcp-server-security-checklist), és tartsuk szűkre az eszközöket, ahogy a lemásolt eszközök nőnek. A transzport külön kérdés: [a stateless migrációs útmutató](https://balazscsorba.com/hu/blog/mcp-2026-07-28-stateless-migration-guide) mintája akkor számít, amikor a szerver kilép a stdióból.

## Hol akad el

Hét szerver kicsi minta, és egyik sem szolgáltatás. Nincs másolható hitelesítési modell, mert a stdio belsőépítészeténél fogva helyi, a everything szerver HTTP útjai pedig fejlesztési transzportok; nincs sebességkorlát, se támogatási nyilatkozat, se a README docker run-ján túli telepítési történet. Az archív szervereket évek óta tartó tutorialok hivatkozzák, aki régi útmutatót követ, tehát egy szándékosan elköltözött repositoryban köt ki. És a gyűjtemény Python fele lemarad az SDK mögött, amelyet mutatnia kellene.

Választás

Mi ez

Támogatás

Mire való

Referenciaszerverek

Hét, az irányító testülettől származó példa a src/ alatt

Közösség és a MCP-irányító testület, sebezhetőség-fogadás nélkül

Protokoll tanulása és saját szerver írása

servers-archived

Tizenhárom kivezetett példa, köztük GitHub, Slack és PostgreSQL

Itt nem karbantartott; a Brave és a Slack a szállítójukhoz került

Történet olvasása, nem új konfigurációk

MCP Registry

Közzétett szerverek katalógusa a registry.modelcontextprotocol.io-n

Az egyes szerverek szerzői, regisztráció kötelező

Futtatni való szerver keresése

FastMCP

Python framework szerverekhez és kliensekhez, 4.0.11 a PyPI-n

A csomag karbantartója

Szerver kiadása a protokoll részletei nélkül

A becsületes összehasonlítás nem az, melyik négyből melyik nyer, hanem hogy mit tanít mindegyik. A framework gyorsabban indítja el a szervert, és eltakarja azt, ami a specifikációverziók között változik. A registry más által írt kódot ad, azon szerző ellenőrzésével, amelyet végzett. A referenciaszerverek az egyetlen választás, amelynek forrását a specifikáció írói írták — épp ezért éri meg őket olvasni, és nem éri meg kiadni.

## Ítélet

Dokumentációként használjuk, amely végre is hajtja magát. Ajánlott mindenkinek, aki MCP-szervert épít, aki ellenőrzi, és aki látni szeretné, hogyan jelennek meg az eszközök, erőforrások és a mintavételezés a vonalon; nem ajánlott alap-repositoryként, termelési eszközök forrásaként vagy klienshez adandó szerverek listájaként.

1.  Olvassuk el a src/-t szerver írása előtt: filesystemet hozzáférés-kezeléshez, everythinget a teljes protokollfelülethez, memoryt nem triviális eszköztervezéshez.
2.  Futtassuk a referenciaszervereket helyben a protokoll tanulásához vagy kliens teszteléséhez, és eszközlistáikat rögzítésként, nem termékként kezeljük.
3.  Tűzzük ki a csomagverziókat minden megtartott konfigurációban, ne a README példák -y jelzőjét használjuk.
4.  Ne telepítsünk referenciaszervert megosztott fiókra: nincs hitelesítés, nincs sebességkorlát, nincs sebezhetőség-fogadás.
5.  A protokolltal kapcsolatos találatokat a SDK repositorykba küldjük, és ha futtatni való szerver kell, a registryt használjuk, nem ezt a repositoryt.

> The servers in this repository are intended as reference implementations to demonstrate MCP features and SDK usage. They are meant to serve as educational examples for developers building their own MCP servers, not as production-ready solutions.

## Források

1.  [MCP-referenciaszerverek repository](https://github.com/modelcontextprotocol/servers)
2.  [A repository README-je és szerverlistája](https://github.com/modelcontextprotocol/servers/blob/main/README.md)
3.  [Biztonsági irányelv](https://github.com/modelcontextprotocol/servers/blob/main/SECURITY.md)
4.  [Kiadási folyamat és trusted publishing](https://github.com/modelcontextprotocol/servers/blob/main/RELEASING.md)
5.  [A filesystem szerver README-je](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)
6.  [A everything szerver funkciólistája](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/docs/features.md)
7.  [MCP Registry](https://registry.modelcontextprotocol.io/)
8.  [Archivált referenciaszerverek](https://github.com/modelcontextprotocol/servers-archived)
9.  [A Model Context Protocol dokumentációja](https://modelcontextprotocol.io/)
10.  [TypeScript MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk)
11.  [Python MCP SDK](https://github.com/modelcontextprotocol/python-sdk)
12.  [FastMCP a PyPI-n](https://pypi.org/project/fastmcp/)

## Gyakori kérdések

Biztonságosan használhatók éles rendszerben az MCP-referenciaszerverek?

Nem, ezt a repository maga is kimondja. A README oktatási példának nevezi őket, amelyek nem termelésre készültek, a SECURITY.md pedig azt rögzíti, hogy erre a repositoryra egyáltalán nem fogadnak el sebezhetőségi bejelentést. Helyben futtassátok tanuláshoz vagy kliens teszteléséhez; valódi fiók elé karbantartott szerver kerüljön.

Melyik referenciaszerver olvassam el először?

A filesystemet, ha a hozzáférés-kezelés a kérdés: a könyvtár-fehérlistája és a Roots-kezelése a gyűjtemény leginkább újrahasznosítható terve. A everythinget, ha az a kérdés, hogy mire képes a protokoll: a három alapprimitív mellett mintavételezést, felhasználói megerősítést, haladásjelzést, strukturált kimenetet és feladatokat is megvalósít.

Hová tűnt a GitHub-, a Slack- és a PostgreSQL-szerver?

A modelcontextprotocol/servers-archived repoziba. Tizenhárom szerver került ki a referenciagyűjteményből; a Brave Search-et a Brave saját maga által fenntartott szervere váltotta, a Slack-szervert pedig most a Zencoder tartja karban.

Miben más ez a repository, mint az MCP Registry?

A registry egy közzétett szerverek katalógusa, amelyet bárki regisztrálhat — ott keres az ember futtatni való szerver. Ez a repository csak a MCP-irányító testület által gondozott hét megvalósítást tartalmazza, és a README a registry látogatóit inkább odairányítja.

Írta: Csorba Balázs

Senior fullstack és AI mérnök Stájerországban – több mint 10 év Vue, Nuxt, Node.js és PHP, ma AI-ügynököknek építek eszközöket.

[AI fejlesztés és MCP szerverek →](https://balazscsorba.com/hu/expertise/ai-engineer)[Rólam →](https://balazscsorba.com/hu/about)

## További cikkek

-   [Eszközök tervezése AI-ágenseknek: nevek, leírások, sémák és hibaüzenetek](https://balazscsorba.com/hu/blog/agent-tool-design-descriptions-errors)
-   [Legacy kódbázis migrálása coding agentekkel: strangler fig playbook](https://balazscsorba.com/hu/blog/coding-agents-legacy-codebase-migration)
-   [Háttérben futó kódoló ügynökök: PR-ek, sorok és review](https://balazscsorba.com/hu/blog/background-agents-async-pr-workflow)
-   [Kontextusromlás hosszan futó ügynököknél: törlés, tömörítés, memória és al-ügynökök](https://balazscsorba.com/hu/blog/context-rot-compaction-long-running-agents)

## Pont erre van szükséged?

Írj a projektedről vagy a pozícióról – szívesen hallok felőled.

[Lépj velem kapcsolatba](mailto:contact@balazscsorba.com) [Kapcsolódjunk LinkedInen](https://www.linkedin.com/in/balazs-csorba)