Confluence MCP-Server

Ein Model Context Protocol (MCP)-Server für die Interaktion mit Confluence Data Center über die REST-API. Dieser Server bietet eine Reihe von Tools, die es KI-Modellen ermöglichen, mit Confluence-Inhalten zu interagieren.

Merkmale

Dieser MCP-Server stellt die folgenden Vorgänge für Confluence bereit:

Führen Sie CQL-Suchen (Confluence Query Language) durch
Seiteninhalt nach ID abrufen
Seiteninhalt mit Body abrufen
Seitensuche mit der Leertaste
Suchen Sie nach einer Seite nach Titel und Leertaste
Neue Seiten erstellen (mit optionaler übergeordneter Seite)
Vorhandene Seiten aktualisieren
Seiten löschen

Installation

Dieses Repository klonen
Installieren Sie Abhängigkeiten:

pip install -r requirements.txt

Konfiguration

Erstellen Sie im Projektstammverzeichnis eine .env Datei mit den folgenden Variablen:

CONFLUENCE_API_BASE=http://localhost:8090/rest/api
CONFLUENCE_USERNAME=your_username
CONFLUENCE_PASSWORD=your_password

Passen Sie die Werte an Ihre Confluence-Instanz an.

Ausführen des Servers

Entwicklungsmodus (empfohlen)

Der richtige Weg, einen MCP-Server zu betreiben, ist die Verwendung des MCP-CLI-Tools im Entwicklungsmodus. Dadurch wird die MCP Inspector-Benutzeroberfläche gestartet, mit der Sie den Server testen und debuggen können:

mcp dev confluence.py

Dadurch wird der MCP Inspector standardmäßig unter http://127.0.0.1:6274 gestartet.

Direkte Ausführung (nicht empfohlen)

MCP-Server sind für den Betrieb mit dem MCP-CLI-Tool oder integriert mit Claude Desktop konzipiert. Die direkte Ausführung mit Python ist nicht die Standardmethode zum Ausführen eines MCP-Servers, das Skript enthält jedoch einen Fallback-Modus zum Testen:

python confluence.py

Dieser Modus verfügt jedoch über eine eingeschränkte Funktionalität und ist nur für grundlegende Tests vorgesehen.

Installation in Claude Desktop

So installieren Sie den Server in Claude Desktop:

mcp install confluence.py

API-Referenz

Führen Sie die CQL-Suche aus

Führen Sie eine CQL-Abfrage in Confluence aus, um Seiten zu durchsuchen.

Parameter:

cql : CQL-Abfragezeichenfolge
limit : Anzahl der zurückzugebenden Ergebnisse (Standard: 10)

get_page_content

Holen Sie sich den Inhalt einer Confluence-Seite.

Parameter:

pageId : Confluence-Seiten-ID

Seite mit Text abrufen

Holen Sie sich eine Seite mit ihrem Hauptinhalt.

Parameter:

pageId : Confluence-Seiten-ID

Seiten nach Speicherplatz suchen

Suchen Sie Seiten mit der Leertaste.

Parameter:

spaceKey : Confluence-Space-Schlüssel
limit : Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 10)
expand : Optionale, durch Kommas getrennte Liste der zu erweiternden Eigenschaften

Seite nach Titel finden

Suchen Sie eine Seite nach Titel und Leerzeichen.

Parameter:

title : Seitentitel
spaceKey : Confluence-Space-Schlüssel

Seite erstellen

Erstellen Sie eine neue Seite in Confluence.

Parameter:

title : Seitentitel
spaceKey : Confluence-Space-Schlüssel
content : Seiteninhalt im Speicherformat (HTML)
parentId : Optionale ID der übergeordneten Seite

Seite aktualisieren

Aktualisieren Sie eine vorhandene Seite in Confluence.

Parameter:

pageId : Confluence-Seiten-ID
content : Neuer Seiteninhalt im Speicherformat (HTML)
title : Optionaler neuer Titel für die Seite
spaceKey : Optionale Leertaste (nur erforderlich, wenn das Leerzeichen geändert wird)

Seite löschen

Löschen Sie eine Seite nach ID.

Parameter:

pageId : Confluence-Seiten-ID

Beispielverwendung

Sobald der Server läuft und mit einem KI-Modell verbunden ist, können Sie mithilfe natürlicher Sprache mit Confluence interagieren. Beispiel:

„Alle Seiten im DOCS-Bereich finden“
„Holen Sie sich den Inhalt der Seite mit der ID 123456“
„Erstellen Sie im TEAM-Bereich eine neue Seite mit dem Titel ‚Besprechungsnotizen‘ und dem Inhalt ‚Notizen von unserer Besprechung‘.“
„Aktualisieren Sie die Seite mit der ID 123456, um den Inhalt ‚Aktualisierte Besprechungsnotizen‘ anzuzeigen.“
„Aktualisieren Sie den Titel der Seite 123456 in ‚Überarbeitete Besprechungsnotizen‘.“

Lizenz

MIT

Confluence MCP Server

Integrations