🚀 Linear-MCP-für-Gemini_CLI

Ein leistungsstarker Open-Source Model Context Protocol (MCP)-Server, der speziell dafür entwickelt wurde, die Gemini CLI direkt mit Ihrem Linear-Workspace zu verbinden. Verwalten Sie Issues, Teams und Workflows nahtlos über natürliche Sprache, direkt von Ihrem Terminal aus.

🌟 Funktionen

• 🔍 Suche & Entdeckung: Finden Sie Issues in Ihrem gesamten Workspace direkt über die Gemini CLI.

• 📝 Issue-Verwaltung: Rufen Sie Issues ab, erstellen und aktualisieren Sie diese (Status, Priorität, Bearbeiter usw.) mühelos.

• 💬 Zusammenarbeit: Fügen Sie Kommentare zu Issues hinzu, ohne Ihr Terminal zu verlassen.

• 🏢 Workspace-Einblicke: Listen Sie Teams, Benutzer und Workflow-Status auf, um Gemini den vollständigen Kontext zu bieten.

• ⚡ Echtzeit-Integration: Basiert auf dem Model Context Protocol für eine sichere Kommunikation mit geringer Latenz.

📋 Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie Folgendes installiert haben:

• Node.js: Version 18.0.0 oder höher.

• Gemini CLI: Installiert und auf Ihrem Computer konfiguriert.

• Linear-Konto: Mit Zugriff zum Generieren eines API-Schlüssels.

📖 Vollständige Gemini CLI-Integrationsanleitung

Dieser Server ist in TypeScript geschrieben. Da die Gemini CLI ein Standard-JavaScript-Executable benötigt, um MCP-Server auszuführen, müssen wir das Projekt zuerst herunterladen und "bauen".

Befolgen Sie diese 4 Schritte, um alles zu verbinden.

Schritt 1: Server herunterladen & bauen

1. Klonen Sie das Repository auf Ihren Computer:

   git clone https://github.com/tenx-studio/Linear-MCP.git
   cd linear-mcp-open-source

2. Installieren Sie die erforderlichen Pakete:

   npm install

3. Kompilieren Sie den Code:

   npm run build

   (Warum das? Dieser Befehl übersetzt den TypeScript-Code in eine dist/index.js-Datei, die genau die Datei ist, die die Gemini CLI zur Kommunikation mit Linear verwendet).

Schritt 2: Holen Sie sich Ihren Linear API-Schlüssel

1. Navigieren Sie in Ihrem Linear-Workspace zu Settings > API > Personal API keys.

2. Klicken Sie auf New API key und geben Sie ihm einen beschreibenden Namen (z. B. "Gemini CLI").

3. Kopieren Sie den Schlüssel (Sie werden ihn für den letzten Schritt benötigen).

Schritt 3: Verbindung zur Gemini CLI herstellen (Die einzige Einrichtung, die Sie benötigen)

Jetzt teilen wir der Gemini CLI mit, wo sie den gebauten Server findet, und stellen ihr sicher Ihren API-Schlüssel zur Verfügung. Dies tun Sie, indem Sie die Einstellungsdatei der Gemini CLI bearbeiten.

1. Suchen Sie Ihre Einstellungsdatei: Öffnen Sie Ihren Datei-Explorer oder Ihr Terminal und suchen Sie den .gemini-Ordner im Home-Verzeichnis Ihres Benutzers:

   • Windows: %USERPROFILE%\.gemini\settings.json (z. B. C:\Users\IhrName\.gemini\settings.json)

   • Mac/Linux: ~/.gemini/settings.json (Hinweis: Falls der .gemini-Ordner oder die settings.json-Datei noch nicht existieren, erstellen Sie diese einfach).

2. Fügen Sie die Konfiguration hinzu: Öffnen Sie settings.json in einem beliebigen Texteditor (wie VS Code, Notepad oder TextEdit) und fügen Sie den folgenden mcp-Block ein. Falls Ihre Datei bereits Inhalt hat, fügen Sie einfach den Abschnitt "mcp" innerhalb der Hauptklammern {} hinzu:

{
  "mcp": {
    "servers": {
      "linear": {
        "command": "node",
        "args": ["/ABSOLUTE/PATH/TO/linear-mcp-open-source/dist/index.js"],
        "env": {
          "LINEAR_API_KEY": "lin_api_your_key_here"
        }
      }
    }
  }
}

⚠️ Wichtige Anpassungen:

• args: Sie MÜSSEN /ABSOLUTE/PATH/TO/... durch den tatsächlichen, vollständigen Pfad auf Ihrem Computer ersetzen, unter dem Sie dieses Repository geklont haben. (z. B. "D:/Projects/linear-mcp-open-source/dist/index.js").

• LINEAR_API_KEY: Ersetzen Sie lin_api_your_key_here durch den exakten API-Schlüssel, den Sie in Schritt 2 kopiert haben.

Schritt 4: Starten Sie den Chat!

Schließen Sie Ihr Terminal und öffnen Sie es erneut, um Ihre Gemini CLI-Sitzung neu zu starten. Die Integration ist jetzt aktiv!

Versuchen Sie, Gemini CLI Dinge zu fragen wie:

"List my Linear teams." "Find the issue about the login bug." "Create a new high priority issue in the Engineering team to update the README."

🤖 Magie der automatischen Verbindung (Wie es funktioniert)

Sie fragen sich vielleicht: "Muss ich jedes Mal npm start ausführen, wenn ich das verwenden möchte? Muss ich manuell eine Serververbindung einrichten?"

Nein! Sie müssen nichts weiter tun.

Das Hinzufügen des Konfigurationsblocks in Schritt 3 ist die einzige erforderliche Einrichtung. Hier ist genau das, was im Hintergrund passiert:

1. Zero-Touch-Start: Da Sie die Konfiguration zu Ihrer settings.json hinzugefügt haben, fungiert die Gemini CLI nativ als Host.

2. Hintergrundausführung: Jedes Mal, wenn Sie einen neuen Gemini CLI-Chat starten, startet dieser automatisch diesen Linear MCP-Server in einem versteckten Hintergrundprozess.

3. Sicherer Handshake: Die Gemini CLI liest den "LINEAR_API_KEY" aus Ihren Einstellungen und injiziert ihn sicher direkt in den Server.

4. Sauberes Herunterfahren: Wenn Sie die Gemini CLI schließen, wird der Hintergrundserver automatisch beendet.

Sie konfigurieren es nur einmal in Ihren Einstellungen, und das Model Context Protocol übernimmt den gesamten Lebenszyklus automatisch für Sie!

🤝 Mitwirken

Beiträge sind das, was die Open-Source-Community zu einem so erstaunlichen Ort zum Lernen, Inspirieren und Erschaffen macht. Jeder Beitrag, den Sie leisten, wird sehr geschätzt.

1. Forken Sie das Projekt

2. Erstellen Sie Ihren Feature-Branch (git checkout -b feature/AmazingFeature)

3. Committen Sie Ihre Änderungen (git commit -m 'Add some AmazingFeature')

4. Pushen Sie in den Branch (git push origin feature/AmazingFeature)

5. Öffnen Sie einen Pull Request

📄 Lizenz

Dieses Projekt ist unter der ISC-Lizenz lizenziert.

Mit ❤️ für die KI-Entwickler-Community gebaut.