Linearer MCP-Integrationsserver

Dieser Server bietet Linear-Integrationsfunktionen über das Model Context Protocol (MCP). Er ermöglicht KI-Modellen die Interaktion mit Linear zur Problemverfolgung und zum Projektmanagement.

Merkmale

Der Server stellt über die MCP-Schnittstelle die folgenden Tools bereit:

linear_create_issue

Erstellt ein neues lineares Problem mit den folgenden Parametern:

• title (erforderlich): Titel der Ausgabe

• teamId (erforderlich): Team-ID, in der das Problem erstellt werden soll

• description (optional): Problembeschreibung (Markdown wird unterstützt)

• priority (optional): Prioritätsstufe (0-4)

• status (optional): Anfänglicher Statusname

lineare_Suchprobleme

Suchen Sie nach linearen Problemen mit flexibler Filterung und Paginierungsunterstützung:

• query (optional): Suchtext im Titel/Beschreibung

• teamId (optional): Nach Team filtern

• status (optional): Filtern nach Status

• assigneeId (optional): Filtern nach Beauftragtem

• priority (optional): Prioritätsstufe (0-4)

• limit (optional, Standard: 10): Maximale Ergebnisse pro Seite

• cursor (optional): Paginierungscursor zum Abrufen der nächsten Seite

• sortBy (optional, Standard: „aktualisiert“): Feld zum Sortieren nach („erstellt“, „aktualisiert“, „Priorität“, „Titel“)

• sortDirection (optional, Standard: „desc“): Sortierrichtung („asc“, „desc“)

lineare_sprint_issues

Alle Probleme im aktuellen Sprint/Iteration abrufen:

• teamId (erforderlich): Team-ID, für die Sprint-Probleme abgerufen werden sollen

lineare_Suchteams

Suchen und Abrufen von Linear-Teams:

• query (optional): Text zur Suche in Teamnamen

linear_filter_sprint_issues

Filtern Sie aktuelle Sprintprobleme nach Status und filtern Sie automatisch nach dem aktuellen Benutzer:

• teamId (erforderlich): Team-ID, für die Sprint-Probleme abgerufen werden sollen

• status (erforderlich): Status, nach dem gefiltert werden soll (z. B. „Ausstehende Produktfreigabe“)

linear_get_issue_details

Erhalten Sie detaillierte Informationen zu einem bestimmten Problem, einschließlich vollständiger Beschreibung, Kommentaren und Metadaten:

• issueId (erforderlich): Problem-ID (z. B. „DATA-1284“), für die Details abgerufen werden sollen

linear_bulk_update_status

Aktualisieren Sie den Status mehrerer linearer Probleme gleichzeitig:

• issueIds (erforderlich): Liste der zu aktualisierenden Problem-IDs (z. B. ["ENG-123", "DATA-456"])

• targetStatus (erforderlich): Zielstatus, der für alle Probleme festgelegt werden soll (z. B. „In Bearbeitung“)

linearer_Verwaltungszyklus

Erstellen, aktualisieren oder erhalten Sie Informationen zu linearen Zyklen (Sprints):

• action (erforderlich): Auszuführende Aktion: „Erstellen“, „Aktualisieren“, „Abrufen“ oder „Auflisten“

• teamId (erforderlich): Team-ID zum Verwalten von Zyklen für

• cycleId (optional, erforderlich für Update- und Get-Aktionen): Zyklus-ID

• name (optional, zum Erstellen erforderlich): Zyklusname

• startDate (optional, zum Erstellen erforderlich): Startdatum im ISO-Format (JJJJ-MM-TT)

• endDate (optional, zum Erstellen erforderlich): Enddatum im ISO-Format (JJJJ-MM-TT)

• description (optional): Zyklusbeschreibung

Related MCP server: Linear MCP Server

Entwickler-Setup

1. Holen Sie sich Ihren Linear-API-Schlüssel aus den Linear-Einstellungen > API-Bereich

2. Erstellen Sie eine .env Datei im Projektstammverzeichnis:

LINEAR_API_KEY=your_api_key_here

3. Installieren Sie Abhängigkeiten:

npm install

4. Starten Sie den Server:

# Development mode with auto-reload
npm run dev

# Production mode
npm start

# Build TypeScript
npm run build

# Run linter
npm run lint

# Run tests
npm run test

# Inspect MCP server
npm run inspect

Technische Details

• Erstellt mit TypeScript und dem Model Context Protocol SDK

• Verwendet Linear SDK für API-Interaktionen

• Beinhaltet Fehlerbehandlung, Ratenbegrenzung und Verbindungsmanagement

• Unterstützt die automatische Wiederverbindung mit konfigurierbaren Wiederholungsversuchen

• Implementiert Heartbeat-Überwachung für die Verbindungsintegrität

• Bietet detaillierte Protokollierung im Debug-Modus

• Verfügt über ein In-Memory-Caching-System für verbesserte Leistung

• Unterstützt die Paginierung zur Verarbeitung großer Ergebnismengen

• Implementiert die Stapelverarbeitung für Massenvorgänge

Leistung und Zuverlässigkeit

Der Server verfügt über umfassende Funktionen für Leistung und Zuverlässigkeit:

Caching-System

• In-Memory-Caching für häufig abgerufene Daten (Teams, Workflow-Status)

• Konfigurierbare TTL (Time To Live) für Cache-Einträge

• Automatische Bereinigung abgelaufener Cache-Einträge

• Cache-Statistiken im Debug-Modus verfügbar

Fehlerbehandlung

• API-Timeout-Schutz mit konfigurierbaren Timeouts

• Automatische Wiederverbindungsversuche bei Verbindungsverlust

• Detaillierte Fehlerprotokollierung mit Zeitstempeln und Kontext

• Ordentliches Herunterfahren mit Bereinigung

• Heartbeat-Überwachung für die Verbindungsintegrität

Leistungsoptimierungen

• Stapelverarbeitung für Massenvorgänge

• Paginierungsunterstützung für große Ergebnismengen

• Parallelverarbeitung mit Promise.all für gleichzeitige Vorgänge

• Effizientes Abrufen von Daten mit minimalen API-Aufrufen

Abhängigkeiten

• @linear/sdk : Linear-API-Client

• @modelcontextprotocol/sdk : MCP-Serverimplementierung

• zod : Laufzeittypprüfung und -validierung

• dotenv : Verwaltung von Umgebungsvariablen

• TypeScript und verwandte Entwicklungstools

Die vollständige Liste der Abhängigkeiten finden Sie unter package.json .

Smithery-Bereitstellung

Dieser Server kann mithilfe der bereitgestellten Konfigurationsdateien auf Smithery.ai bereitgestellt werden:

Voraussetzungen

• Ein Smithery.ai-Konto

• Ihr Linear-API-Schlüssel

Bereitstellungsschritte

1. Fügen Sie dieses Repository zu Smithery hinzu oder beanspruchen Sie einen vorhandenen Server

2. Greifen Sie auf die Registerkarte „Bereitstellungen“ zu (nur authentifizierte Besitzer)

3. Konfigurieren Sie die Bereitstellung mit Ihrem Linear-API-Schlüssel

4. Bereitstellen des Servers

Konfigurationsdateien

Das Repository enthält zwei wichtige Dateien für die Smithery-Bereitstellung:

1. Dockerfile : Definiert den Server-Build-Prozess

   • Verwendet Node.js 18 Alpine als Basis-Image

   • Installiert Abhängigkeiten und erstellt den TypeScript-Code

   • Richtet den Befehl zum Ausführen des Servers ein

2. smithery.yaml : Definiert die Server-Startkonfiguration

   • Gibt den Befehl zum Ausführen des Servers an

   • Definiert die erforderlichen Konfigurationsparameter (Linear API-Schlüssel)

   • Behandelt die Einrichtung von Umgebungsvariablen

Lokales Testen

Sie können die Smithery-Konfiguration lokal mit dem MCP Inspector testen:

# Build the Docker image
docker build -t linear-mcp-server .

# Run the container with your Linear API key
docker run -e LINEAR_API_KEY=your_api_key_here linear-mcp-server

# Or use the MCP Inspector
npm run inspect