Linear MCP Integration Server

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 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

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
  1. Installieren Sie Abhängigkeiten:
npm install
  1. 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
-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Merkmale
    1. linear_create_issue
    2. lineare_Suchprobleme
    3. lineare_sprint_issues
    4. lineare_Suchteams
    5. linear_filter_sprint_issues
    6. linear_get_issue_details
    7. linear_bulk_update_status
    8. linearer_Verwaltungszyklus
  2. Entwickler-Setup
    1. Technische Details
      1. Leistung und Zuverlässigkeit
        1. Caching-System
        2. Fehlerbehandlung
        3. Leistungsoptimierungen
      2. Abhängigkeiten
        1. Smithery-Bereitstellung
          1. Voraussetzungen
          2. Bereitstellungsschritte
          3. Konfigurationsdateien
          4. Lokales Testen

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          Enables AI agents to manage issues, projects, and teams on the Linear platform programmatically.
          Last updated -
          7
          123
          22
          JavaScript
          MIT License
          • Apple
        • -
          security
          F
          license
          -
          quality
          Enables 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
        • A
          security
          A
          license
          A
          quality
          A 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 -
          5
          6
          Python
          Apache 2.0
        • A
          security
          A
          license
          A
          quality
          Provides 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 -
          5
          TypeScript
          MIT License

        View all related MCP servers

        ID: 95yu0123ap