Integrations
Used for environment variable management, specifically to load the Linear API key for authentication with Linear's API.
Provides tools for interacting with Linear for issue tracking and project management, including creating issues, searching issues, retrieving sprint issues, searching teams, filtering sprint issues, and bulk updating issue statuses.
Supported in Linear issue descriptions, allowing rich text formatting when creating issues.
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 AusgabeteamId
(erforderlich): Team-ID, in der das Problem erstellt werden solldescription
(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/BeschreibungteamId
(optional): Nach Team filternstatus
(optional): Filtern nach StatusassigneeId
(optional): Filtern nach Beauftragtempriority
(optional): Prioritätsstufe (0-4)limit
(optional, Standard: 10): Maximale Ergebnisse pro Seitecursor
(optional): Paginierungscursor zum Abrufen der nächsten SeitesortBy
(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 sollenstatus
(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ürcycleId
(optional, erforderlich für Update- und Get-Aktionen): Zyklus-IDname
(optional, zum Erstellen erforderlich): ZyklusnamestartDate
(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
Entwickler-Setup
- Holen Sie sich Ihren Linear-API-Schlüssel aus den Linear-Einstellungen > API-Bereich
- Erstellen Sie eine
.env
Datei im Projektstammverzeichnis:
- Installieren Sie Abhängigkeiten:
- Starten Sie den Server:
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-Serverimplementierungzod
: Laufzeittypprüfung und -validierungdotenv
: 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
- Fügen Sie dieses Repository zu Smithery hinzu oder beanspruchen Sie einen vorhandenen Server
- Greifen Sie auf die Registerkarte „Bereitstellungen“ zu (nur authentifizierte Besitzer)
- Konfigurieren Sie die Bereitstellung mit Ihrem Linear-API-Schlüssel
- Bereitstellen des Servers
Konfigurationsdateien
Das Repository enthält zwei wichtige Dateien für die Smithery-Bereitstellung:
- 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
- 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:
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Ermöglicht KI-Modellen die Interaktion mit Linear zur Problemverfolgung und zum Projektmanagement über das Model Context Protocol und unterstützt Funktionen wie das Erstellen von Problemen, Suchen, Verwalten von Sprints und Massenaktualisierung von Status.
Related MCP Servers
- AsecurityAlicenseAqualityEnables AI agents to manage issues, projects, and teams on the Linear platform programmatically.Last updated -712322JavaScriptMIT License
- -securityFlicense-qualityEnables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.Last updated -TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.Last updated -56PythonApache 2.0
- AsecurityAlicenseAqualityProvides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.Last updated -5TypeScriptMIT License