Palald/mcp-sdk-typescript

Was macht mcp-sdk-typescript?

🚀 Erstellen Sie effiziente Anwendungen mit dem MCP SDK für TypeScript, das optimierte Leistung, Echtzeitkommunikation und robustes Sitzungsmanagement bietet.

Übersicht

Das MCP SDK für TypeScript ermöglicht die schnelle Entwicklung von Anwendungen, die auf dem Model Context Protocol (MCP) basieren. Es bietet:

• Optimierte Leistung durch asynchrone und typsichere APIs
• Echtzeitkommunikation über JSON-RPC 2.0
• Robustes Sitzungsmanagement mit Unterstützung für Authentifizierung und Autorisierung
• Flexible Transportprotokolle wie SSE (Server-Sent Events) und stdio

Installation

npm install @mcp/sdk-typescript

Schnellstart

Erstellen eines MCP-Servers

import { Server } from '@mcp/sdk-typescript';

const server = new Server({
  name: 'example-server',
  version: '1.0.0',
});

server.tool('get_weather', {
  city: { type: 'string' },
}, async ({ city }, ctx) => {
  return { content: `Das Wetter in ${city} ist sonnig.` };
});

server.listen({ transport: 'stdio' });

Verbinden eines MCP-Clients

import { Client } from '@mcp/sdk-typescript';

const client = new Client();
await client.connect({
  transport: 'stdio',
  command: 'node',
  args: ['./server.js'],
});

const tools = await client.listTools();
console.log(tools);

Transportoptionen

Transport	Beschreibung	Verwendung
stdio	Standard-Eingabe/Ausgabe für lokale Prozesse	Ideal für CLI-Integrationen
sse	Server-Sent Events für Remote-Verbindungen	Geeignet für Webanwendungen

Sitzungsmanagement

Das SDK bietet integrierte Unterstützung für:

• Erstellung und Verwaltung von Sitzungen
• Authentifizierung und Autorisierung (optional)
• Fehlerbehandlung und Wiederherstellungsmechanismen

API-Referenz

Server

• Server(options): Erstellt eine neue Serverinstanz
• server.tool(name, schema, handler): Registriert ein Tool
• server.listen(options): Startet den Server mit dem angegebenen Transport

Client

• Client(options): Erstellt eine neue Clientinstanz
• client.connect(options): Stellt eine Verbindung zu einem MCP-Server her
• client.listTools(): Listet verfügbare Tools auf

Beispiele

Weitere Beispiele finden Sie im Beispiele-Verzeichnis.

Lizenz

MIT