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

Related MCP server: OmniMCP

Installation

1. Dieses Repository klonen

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