\n English<\/a>.<\/p>\n
It was translated with technical assistance and editorially reviewed before publication.\n <\/p>\n
Das KI-Unternehmen Anthropic, das 2021 von ehemaligen OpenAI-Mitarbeitern gegr\u00fcndet wurde, hat das Model Context Protocol (MCP) mit dem Ziel einer Standardisierung der Kommunikation zwischen Large Language Models und externen Datenquellen entwickelt. Beim sogenannten Tool Calling hat das LLM die M\u00f6glichkeit, auf vordefinierte Schnittstellen zuzugreifen. Diese lassen sich parametrisieren und erlauben so gro\u00dfe Flexibilit\u00e4t. Die meisten LLM-Anbieter unterst\u00fctzen dieses Feature. Jede Datenquelle braucht dabei eine Verkn\u00fcpfung \u00fcber eine eigene Funktion, was in der Regel eine Anpassung am Programmcode erforderlich macht.<\/p>\n
<\/p>\n
\n Sebastian Springer weckt als Dozent f\u00fcr JavaScript, Sprecher auf zahlreichen Konferenzen und Autor die Begeisterung f\u00fcr professionelle Entwicklung mit JavaScript. <\/p>\n
Das Model Context Protocol soll die Verkn\u00fcpfung externer Datenquellen deutlich vereinfachen und es erlauben, externe Schnittstellen, Datenbanken, Unternehmenssysteme oder Dateisysteme ohne zus\u00e4tzliche Anpassung direkt anzubinden. Dieser Artikel widmet sich den technischen Details der Funktionsweise des MCP und zeigt anhand eines konkreten Beispiels mit dem MCP-TypeScript-SDK, wie eine Integration in eine Applikation gelingen kann.<\/p>\n
Die zentrale Anlaufstelle f\u00fcr Ressourcen zum Thema MCP sind zum einen die offizielle Website des Projekts<\/a> und zum anderen das GitHub-Repo<\/a>. Dort stehen die Dokumentation, die Spezifikation und eine ganze Reihe von Software Development Kits (SDKs) f\u00fcr verschiedene Programmiersprachen wie Python, TypeScript, C# oder Kotlin zur Verf\u00fcgung.<\/p>\n Die Architektur einer MCP-Applikation<\/p>\n Eine Applikation, die das MCP nutzt, besteht aus verschiedenen Komponenten:<\/p>\n MCP-Server<\/p>\n Ein MCP-Server kann direkt in eine Applikation integriert, aber auch, und das wird der h\u00e4ufigere Fall sein, ein eigenst\u00e4ndiger Dienst sein. Die MCP-Initiative stellt eine Reihe von SDKs in unterschiedlichen Programmiersprachen bereit, die die Grundlage f\u00fcr die Serverimplementierung bilden. Der Server selbst ist modular aufgebaut und erlaubt verschiedene Transportmechanismen, \u00fcber die er mit den Clients kommuniziert. Das TypeScript-SDK sieht aktuell die Transportmechanismen Streamable HTTP, SSE und stdio vor. Streamable HTTP und SSE basieren auf HTTP, wobei die MCP-Spezifikation vom 26.03.2025<\/a> den SSE-Transport als veraltet (deprecated) markierte und die Version vom 18.06.2025 (latest)<\/a> SSE bereits nicht mehr erw\u00e4hnt.<\/p>\n Ein MCP-Client kann die HTTP-basierten Transportmechanismen verwenden, um sich mit einem entfernten Server zu verbinden. Der stdio-Transport ist f\u00fcr lokale Anwendungen gedacht. Hierbei verbindet sich der Client \u00fcber die Standard-Ein- und -Ausgabe mit dem Server. Dieser Weg arbeitet deutlich schneller, ist jedoch nur f\u00fcr die Verwendung auf einem System geeignet. Das Python-SDK definiert zus\u00e4tzlich zu diesen Transporttypen noch weitere wie den ASGI-Transport (Asynchronous Server Gateway Interface), eine Schnittstelle aus der Python-Welt, die neben der Kommunikation \u00fcber HTTP noch weitere Protokolle wie WebSockets oder benutzerdefinierte Protokolle unterst\u00fctzt.<\/p>\n Die MCP-Spezifikation unterteilt die Features, die ein Server seinen Clients bietet, in drei Kategorien: Resources, Tools und Prompts.<\/p>\n Resources<\/p>\n Mit der Feature-Kategorie Resources stellt ein MCP-Server Daten zur Verf\u00fcgung. Ein typisches Beispiel ist die Anbindung an eine Datenbank. Resources sollten Daten nur lesend zur Verf\u00fcgung stellen, keine komplexen Berechnungen durchf\u00fchren und keine Seiteneffekte wie Datenmanipulationen aufweisen. Sie sind parametrisierbar, um die Abfrage zu beeinflussen und eine h\u00f6here Flexibilit\u00e4t zu erreichen.<\/p>\n Die MCP-Spezifikation sieht vor, dass das Format [protocol]:\/\/[host]\/[path] Resources spezifiziert. Ein Beispiel k\u00f6nnte folgenderma\u00dfen aussehen: postgres:\/\/database\/users. Die Antwort auf eine Resources-Anfrage kann entweder im Textformat wie beispielsweise JSON oder als Bin\u00e4rdaten wie PDFs oder Bilder erfolgen.<\/p>\n Der MCP-Server stellt \u00fcber den Endpunkt resources\/list eine Liste der verf\u00fcgbaren Resources zur Verf\u00fcgung. Jeder Datensatz weist mindestens die URL der jeweiligen Resource und einen menschenlesbaren Namen auf. Hinzu kommen noch eine optionale Beschreibung und ein ebenfalls optionaler MIME-Type, der das Format der R\u00fcckmeldung spezifiziert.<\/p>\n Die Spezifikation sieht nicht nur den lesenden Zugriff auf Ressourcen vor, sondern auch einen Benachrichtigungsmechanismus, \u00fcber den der Server registrierte Clients \u00fcber \u00c4nderungen der verf\u00fcgbaren sowie Daten\u00e4nderungen einer einzelnen Resource benachrichtigen kann.<\/p>\n Tools<\/p>\n Die Features der Kategorie Tools d\u00fcrfen Berechnungen durchf\u00fchren und Seiteneffekte aufweisen. Clients m\u00fcssen ber\u00fccksichtigen, dass eine Toolausf\u00fchrung im Vergleich zu einer Ressourcenabfrage l\u00e4nger dauern kann. Diese Werkzeuge k\u00f6nnen Funktionen sein, die aufgrund einer Eingabe eine bestimmte Ausgabe produzieren, aber auch Schnittstellen zu Datenbanken und anderen Systemen, um dort gespeicherte Informationen zu manipulieren. \u00c4hnlich wie Resources k\u00f6nnen Clients auch die verf\u00fcgbaren Tools eines Servers \u00fcber einen Endpunkt auslesen. Dieser lautet tools\/list.<\/p>\n Die Beschreibung eines MCP-Tools ist etwas umfangreicher als die einer Resource. Sie enth\u00e4lt einen Namen und ein Input-Schema, um die Parameter des Tools zu beschreiben. Hinzu kommen noch dessen optionale Beschreibung und optionale Metadaten \u00fcber die Tool-Annotations. Die Annotations liefern Clients beziehungsweise Hinweise f\u00fcr Entwicklerinnen und Entwicklern \u00fcber das Verhalten eines Tools. Die meisten vordefinierten Annotations der MCP-Spezifikation sind Boolean-Werte. So sagt beispielsweise die readOnlyHint-Annotation aus, dass das Tool sein Umfeld nicht modifiziert. Wie auch bei den Resources kann ein Client sich beim Server registrieren, um \u00fcber \u00c4nderungen benachrichtigt zu werden.<\/p>\n Prompts<\/p>\n Prompts sind Vorlagen, die dem MCP-Host die Arbeit mit dem Large Language Model (LLM) erleichtern. Damit kann eine MCP-Applikation nicht nur die Kommunikation zwischen Client und Server, sondern auch zum LLM hin standardisieren. Bei einer Applikation, die ein Code-Review-Feature anbietet, dient der Prompt beispielsweise dazu, den zu \u00fcberpr\u00fcfenden Code korrekt einzubetten. Laut der MCP-Spezifikation besitzen die Prompt-Templates einen eindeutigen Namen. Zus\u00e4tzlich sieht die Spezifikation noch die optionalen Felder description f\u00fcr eine menschenlesbare Beschreibung und arguments mit einer Liste der unterst\u00fctzten Argumente des Schemas vor.<\/p>\n Die Prompt-Endpunkte eines MCP-Servers kommen \u00e4hnlich wie Tools zum Einsatz. Der Client fragt nach dem eindeutigen Identifier und \u00fcbermittelt die ben\u00f6tigten Werte. Der Server antwortet mit dem Prompt, in den die Werte integriert sind, sodass der Client beziehungsweise die Host-Applikation den Prompt direkt verwenden kann.F\u00fcr eine Liste aller verf\u00fcgbaren Prompts bietet der MCP-Server den Endpunkt prompts\/list an.<\/p>\n Die SDKs, die die MCP-Initiative zur Verf\u00fcgung stellt, implementieren die Spezifikation und dienen als Grundlage f\u00fcr die Implementierung von MCP-Servern und MCP-Clients. Das folgende Beispiel implementiert einen einfachen MCP-Server mit je einer Resource, einem Tool und einem Prompt mit dem TypeScript-SDK.<\/p>\n import { const server = new McpServer({ server.tool( server.resource( const filteredList = return { server.prompt( let promptInstructions = `Please generate a compelling product description.`;<\/p>\n let promptCore = `The product is named „${productName}“. `; let refinements = “;<\/p>\n if (length) { const fullPrompt = `${promptInstructions}\\n\\nProduct Details:\\n${promptCore}\\n\\nStyle and Constraints:\\n${refinements.trim()}`;<\/p>\n return { const transport = new StdioServerTransport(); Listing 1: MCP-Serverimplementierung<\/p>\n Die Grundlage f\u00fcr das Beispiel bildet das TypeScript-SDK, das mit dem Kommando npm install @modelcontextprotocol\/sdk installiert wird. Das Paket stellt mit der McpServer-Klasse die Grundlage f\u00fcr die Serverimplementierung zur Verf\u00fcgung. Auf der Server-Instanz sind die Methoden tool, resource und prompt implementiert, die die Schnittstelle zur Registrierung der verschiedenen MCP-Features darstellen. Nachdem die Applikation alle Features registriert hat, ruft sie die connect-Methode der Serverinstanz auf und \u00fcbergibt ein Transport-Objekt. Das kann wie im Beispiel eine Instanz der StdioServerTransport-Klasse f\u00fcr den Stdio-Transport sein oder auch eine Instanz der StreamableHTTPServerTransport-Klasse f\u00fcr eine Remote-Schnittstelle \u00fcber Streamable-HTTP. Alternativ dazu unterst\u00fctzt das TypeScript-SDK auch noch die SSEServerTransport-Klasse f\u00fcr Server Sent Events als Transportmethode.<\/p>\n F\u00fcr die Implementierung der einzelnen Features des MCP-Servers gelten einige Regeln, die das SDK mit einer sehr strikten Schemavalidierung absichert. Folgt die Implementierung nicht diesen Regeln, l\u00e4sst sich der Serverprozess nicht starten. Die Validierung stellt auch die Konsistenz der Argumente beim Aufruf sicher und spielt damit eine wichtige Rolle bei der Sicherheit in der Applikation.<\/p>\n Resource im Beispiel<\/p>\n Zur Definition von Resources sieht das SDK die resource-Methode des Serverobjekts vor. Diese Methode akzeptiert die Bezeichnung der Resource, die zugeh\u00f6rige URL und eine Callback-Funktion, die das Ergebnis produziert. Die Callback-Funktion darf asynchron sein, sodass auch der Anbindung einer Datenbank nichts im Wege steht. Eine Besonderheit gibt es bei der Registrierung von Resources allerdings: Ist die URL als Zeichenkette angegeben, darf sie keine dynamischen Parameter enthalten. F\u00fcr diesen Fall akzeptiert die resource-Methode eine ResourceTemplate-Instanz. Hier werden die Parameter im Pfad mit geschweiften Klammern gekennzeichnet. Die Callback-Funktion kann \u00fcber ihr zweites Argument auf die Parameter der URL zugreifen und das Ergebnis entsprechend modifizieren.<\/p>\n Im Beispiel ist die Resource eine statische Preisliste f\u00fcr eine Reihe von Produkten. Sie tr\u00e4gt die Bezeichnung price-list und ist \u00fcber die URL price-list:\/\/products\/{category} erreichbar, wobei category f\u00fcr eine Kategorie steht, nach der die Callback-Funktion die Datens\u00e4tze filtert. Das TypeScript-SDK arbeitet mit Zod als Validierungsbibliothek und nutzt diese beispielsweise f\u00fcr die \u00dcberpr\u00fcfung des R\u00fcckgabewerts der Resource-Callback-Funktion, sodass diese verpflichtend eine gewisse Struktur zur\u00fcckgeben muss. Das contents-Array im R\u00fcckgabewert kann eine Reihe von Objekten aufweisen, die mindestens \u00fcber die Eigenschaften uri und text verf\u00fcgen m\u00fcssen. Zus\u00e4tzlich akzeptiert das SDK noch weitere Eigenschaften wie json, in der die Daten als JSON-Objekt vorliegen d\u00fcrfen.<\/p>\n \n Dieser Link ist leider nicht mehr g\u00fcltig.\n <\/p>\n Links zu verschenkten Artikeln werden ung\u00fcltig, Sie ben\u00f6tigen ein heise+ Paket, um diesen Artikel zu lesen. Jetzt eine Woche unverbindlich testen \u2013 ohne Verpflichtung!<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"close notice This article is also available in English. It was translated with technical assistance and editorially reviewed…\n","protected":false},"author":2,"featured_media":359143,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[135],"tags":[84847,29,30,196,1256,98995,98996,190,189,194,191,98997,193,192],"class_list":{"0":"post-359142","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-wissenschaft-technik","8":"tag-anthropic","9":"tag-deutschland","10":"tag-germany","11":"tag-it","12":"tag-kuenstliche-intelligenz","13":"tag-large-language-model","14":"tag-model-context-protocol","15":"tag-science","16":"tag-science-technology","17":"tag-technik","18":"tag-technology","19":"tag-typescript","20":"tag-wissenschaft","21":"tag-wissenschaft-technik"},"share_on_mastodon":{"url":"https:\/\/pubeurope.com\/@de\/115060845102760287","error":""},"_links":{"self":[{"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/posts\/359142","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/comments?post=359142"}],"version-history":[{"count":0,"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/posts\/359142\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/media\/359143"}],"wp:attachment":[{"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/media?parent=359142"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/categories?post=359142"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.europesays.com\/de\/wp-json\/wp\/v2\/tags?post=359142"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\n McpServer,
\n ResourceTemplate,
\n} from ‚@modelcontextprotocol\/sdk\/server\/mcp.js‘;
\nimport { StdioServerTransport } from ‚@modelcontextprotocol\/sdk\/server\/stdio.js‘;
\nimport { z } from ‚zod‘;<\/p>\n
\n name: ‚mcp-server‘,
\n version: ‚1.0.0‘,
\n});<\/p>\n
\n ‚currency-converter‘,
\n ‚Convert currency between EUR and USD‘,
\n {
\n amount: z.number(),
\n from: z.enum([‚EUR‘, ‚USD‘]),
\n to: z.enum([‚EUR‘, ‚USD‘]),
\n },
\n async ({ amount, from, to }) => {
\n const exchangeRate =
\n from === ‚EUR‘ && to === ‚USD‘
\n ? 1.1
\n : from === ‚USD‘ && to === ‚EUR‘
\n ? 0.91
\n : 1;
\n const convertedAmount = amount * exchangeRate;
\n return {
\n content: [
\n {
\n type: ‚text‘,
\n text: `${amount} ${from} is ${convertedAmount.toFixed(2)} ${to}`,
\n },
\n ],
\n };
\n }
\n);<\/p>\n
\n ‚price-list‘,
\n new ResourceTemplate(‚price-list:\/\/products\/{category}‘, {
\n list: undefined,
\n }),
\n async (uri, { category }) => {
\n const priceList = [
\n { name: ‚Apple‘, category: ‚Fruit‘, price: 1.2 },
\n { name: ‚Banana‘, category: ‚Fruit‘, price: 0.8 },
\n { name: ‚Carrot‘, category: ‚Vegetable‘, price: 0.5 },
\n { name: ‚Bread‘, category: ‚Bakery‘, price: 2.5 },
\n { name: ‚Milk‘, category: ‚Dairy‘, price: 1.5 },
\n ];<\/p>\n
\n category !== ‚all‘
\n ? priceList.filter(
\n (item) => item.category.toLowerCase() === category.toLowerCase()
\n )
\n : priceList;<\/p>\n
\n contents: [
\n {
\n uri: uri.href,
\n text: JSON.stringify(filteredList),
\n json: filteredList,
\n },
\n ],
\n };
\n }
\n);<\/p>\n
\n ‚get-product-description-prompt‘,
\n {
\n productName: z.string().describe(‚The name of the product.‘),
\n length: z
\n .enum([’short‘, ‚medium‘, ‚long‘])
\n .optional()
\n .describe(‚The desired length of the description.‘),
\n },
\n async (input) => {
\n const { productName, length } = input;<\/p>\n
\n promptCore += `Focus on its general benefits and appeal. `;<\/p>\n
\n let lengthGuidance = “;
\n if (length === ’short‘)
\n lengthGuidance = ‚Keep it concise, around 1-2 sentences. ‚;
\n if (length === ‚medium‘)
\n lengthGuidance = ‚Aim for a paragraph of about 3-5 sentences. ‚;
\n if (length === ‚long‘)
\n lengthGuidance =
\n ‚Provide a detailed description, potentially multiple paragraphs. ‚;
\n refinements += lengthGuidance;
\n }<\/p>\n
\n messages: [
\n {
\n role: ‚user‘,
\n content: {
\n type: ‚text‘,
\n text: fullPrompt,
\n },
\n },
\n ],
\n };
\n }
\n);<\/p>\n
\nawait server.connect(transport);<\/p>\n
\n wenn diese \u00e4lter als 7\u00a0Tage sind oder zu oft aufgerufen wurden.\n <\/p>\n