Linearer MCP-Server

Hinweis: Dies ist eine benutzerdefinierte Implementierung. Informationen zum offiziellen Cline Linear MCP-Server finden Sie unter cline/linear-mcp .

Ein Model Context Protocol (MCP)-Server, der Tools für die Interaktion mit der API von Linear bereitstellt und es KI-Agenten ermöglicht, Probleme, Projekte und Teams programmgesteuert über die Linear-Plattform zu verwalten.

Merkmale

Problemmanagement
- Erstellen Sie neue Probleme mit anpassbaren Eigenschaften (Titel, Beschreibung, Team, Beauftragter, Priorität, Beschriftungen).
- Listen Sie Probleme mit flexiblen Filteroptionen auf (Team, Beauftragter, Status)
- Aktualisieren vorhandener Probleme (Titel, Beschreibung, Status, Beauftragter, Priorität)
Teammanagement
- Alle Teams im Arbeitsbereich auflisten
- Zugriff auf Teamdetails, einschließlich ID, Name, Schlüssel und Beschreibung
Projektmanagement
- Alle Projekte mit optionaler Teamfilterung auflisten
- Projektdetails anzeigen, einschließlich Name, Beschreibung, Status und zugehörige Teams

Voraussetzungen

Node.js (v16 oder höher)
Ein Linear-Konto mit API-Zugriff
Linearer API-Schlüssel mit entsprechenden Berechtigungen

Schnellstart

Holen Sie sich Ihren Linear-API-Schlüssel aus den Entwicklereinstellungen von Linear
Führen Sie es mit Ihrem API-Schlüssel aus:

LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

Oder legen Sie es in Ihrer Umgebung fest:

export LINEAR_API_KEY=your-api-key
npx @ibraheem4/linear-mcp

Entwicklungs-Setup

Klonen Sie das Repository:

git clone [repository-url]
cd linear-mcp

Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie das Projekt:

npm run build

Ausführen mit Inspector

Für die lokale Entwicklung und das Debuggen können Sie den MCP Inspector verwenden:

Supergateway installieren:

npm install -g supergateway

Verwenden Sie das enthaltene Skript run.sh :

chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh

Zugriff auf den Inspektor:
- Öffnen Sie localhost:1337 in Ihrem Browser
- Der Inspector verbindet sich über Server-Sent Events (SSE)
- Testen und Debuggen von Toolaufrufen über die Inspector-Schnittstelle

Konfiguration

Konfigurieren Sie den MCP-Server in Ihrer Einstellungsdatei basierend auf Ihrem Client:

Für Claude Desktop

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Für die VS Code-Erweiterung (Cline)

Speicherort: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Für Cursor ( cursor.sh )

Für Cursor muss der Server mit dem vollständigen Pfad ausgeführt werden:

node /Users/ibraheem/Projects/linear-mcp/build/index.js

Verfügbare Tools

Problem erstellen

Erstellt ein neues Problem in Linear.

{
  title: string;          // Required: Issue title
  description?: string;   // Optional: Issue description (markdown supported)
  teamId: string;        // Required: Team ID
  assigneeId?: string;   // Optional: Assignee user ID
  priority?: number;     // Optional: Priority (0-4)
  labels?: string[];     // Optional: Label IDs to apply
}

Probleme auflisten

Listet Probleme mit optionalen Filtern auf.

{
  teamId?: string;      // Optional: Filter by team ID
  assigneeId?: string;  // Optional: Filter by assignee ID
  status?: string;      // Optional: Filter by status
  first?: number;       // Optional: Number of issues to return (default: 50)
}

Aktualisierungsproblem

Aktualisiert ein bestehendes Problem.

{
  issueId: string;       // Required: Issue ID
  title?: string;        // Optional: New title
  description?: string;  // Optional: New description
  status?: string;      // Optional: New status
  assigneeId?: string;  // Optional: New assignee ID
  priority?: number;    // Optional: New priority (0-4)
  labels?: string[];   // Optional: Label IDs to apply to the issue
}

list_teams

Listet alle Teams im Arbeitsbereich auf. Keine Parameter erforderlich.

Projektliste

Listet alle Projekte mit optionaler Filterung auf.

{
  teamId?: string;     // Optional: Filter by team ID
  first?: number;      // Optional: Number of projects to return (default: 50)
}

Problem melden

Ruft detaillierte Informationen zu einem bestimmten Problem ab.

{
  issueId: string; // Required: Issue ID
}

Entwicklung

Für die Entwicklung mit automatischem Rebuild:

npm run watch

Fehlerbehandlung

Der Server beinhaltet eine umfassende Fehlerbehandlung für:

Ungültige API-Schlüssel
Fehlende erforderliche Parameter
Lineare API-Fehler
Ungültige Werkzeuganforderungen

Alle Fehler werden ordnungsgemäß formatiert und mit beschreibenden Meldungen zurückgegeben.

Technische Details

Gebaut mit:

Typoskript
Linear SDK (@linear/sdk v37.0.0)
MCP SDK (@modelcontextprotocol/sdk v0.6.0)

Der Server verwendet stdio zur Kommunikation und implementiert das Model Context Protocol für eine nahtlose Integration mit KI-Agenten.

Lizenz

MIT

Linear MCP Server

Integrations