mcp-wiki-helper-tools

MCP-Server zum Abfragen eines Wikis, das in einem Git-Repository gespeichert ist.

Er synchronisiert das Wiki, indexiert die Markdown-Dateien und bietet Werkzeuge zum Auflisten, Durchsuchen und Lesen von Dokumenten in Codex oder VS Code.

Funktionen

Related MCP server: knowledge-mcp

So funktioniert es

1. Der MCP klont oder aktualisiert das Git-Repository des Wikis.

2. Er findet alle .md-Dateien.

3. Er erstellt einen Index im Speicher.

4. Er stellt die Werkzeuge über die HTTP-Route /mcp bereit.

5. Er aktualisiert das Wiki regelmäßig.

Der in WIKI_LOCAL_PATH definierte Ordner wird mit git reset --hard aktualisiert. Nehmen Sie keine manuellen Änderungen daran vor, da diese verworfen werden.

1. Server konfigurieren

Auf dem Rechner, auf dem der MCP laufen soll, wechseln Sie in den Projektordner:

cd "/caminho/para/mcp-wiki-helper"

Installieren Sie die Abhängigkeiten:

npm install

Erstellen Sie die Datei .env:

cp .env.example .env

Füllen Sie die .env aus:

WIKI_REPOSITORY_URL=git@github.com:empresa/wiki.git
WIKI_LOCAL_PATH=./data/wiki
WIKI_BRANCH=main
WIKI_SYNC_INTERVAL_MS=1800000

MCP_HTTP_HOST=0.0.0.0
MCP_HTTP_PORT=3000
MCP_HTTP_ROUTE=/mcp

Um den ersten Test im lokalen Netzwerk zu erleichtern, konfigurieren Sie MCP_API_KEY nicht.

2. Server starten

Kompilieren:

npm run build

Starten:

npm run start:http

Lassen Sie dieses Terminal geöffnet. Die erwartete Meldung ist:

[MCP] HTTP ativo em http://0.0.0.0:3000/mcp

Ermitteln Sie die IP des Rechners:

hostname -I

Falls erforderlich, geben Sie den Port im lokalen Netzwerk frei:

sudo ufw allow from 192.168.0.0/16 to any port 3000 proto tcp

3. Verbindung testen

Führen Sie auf dem anderen Rechner aus:

curl http://IP_DO_SERVIDOR:3000/health

Beispiel:

curl http://192.168.3.233:3000/health

Erwartete Antwort:

{
  "status": "ok",
  "documents": 100
}

Das Feld documents muss größer als null sein.

4. In Codex verbinden

In Codex:

1. Öffnen Sie Settings.

2. Gehen Sie zu MCP servers.

3. Klicken Sie auf + Add server.

4. Wählen Sie den Typ URL/HTTP.

5. Verwenden Sie den Namen wiki-helper.

6. Füllen Sie nur die URL aus:

http://IP_DO_SERVIDOR:3000/mcp

Beispiel:

http://192.168.3.233:3000/mcp

Lassen Sie diese Felder vollständig leer:

• Bearer token env var

• Headers

• Headers from environment variables

Schreiben Sie nicht none in die Authentifizierungsfelder.

Danach:

1. Speichern Sie den Server.

2. Aktivieren Sie den Schalter neben wiki-helper.

3. Öffnen Sie eine neue Unterhaltung in Codex.

4. Senden Sie:

Use list_documents do MCP wiki-helper e mostre os primeiros 10 documentos.

Wenn Codex meldet, dass die Umgebungsvariable none nicht existiert:

1. Öffnen Sie Settings > MCP servers > wiki-helper.

2. Klicken Sie auf Uninstall.

3. Fügen Sie ihn erneut hinzu, indem Sie nur die URL ausfüllen.

4. Lassen Sie alle Authentifizierungsfelder leer.

5. In VS Code/Copilot verbinden

In VS Code:

1. Drücken Sie Ctrl+Shift+P.

2. Führen Sie MCP: Open User Configuration aus.

3. Fügen Sie in die Datei mcp.json ein:

{
  "servers": {
    "wiki-helper": {
      "type": "http",
      "url": "http://IP_DO_SERVIDOR:3000/mcp"
    }
  }
}

Führen Sie dann MCP: List Servers aus, wählen Sie wiki-helper und wählen Sie Start Server.

6. Beispiele für die Verwendung

Server überprüfen:

Use a ferramenta Server do MCP wiki-helper.

Dokumente auflisten:

Use list_documents do wiki-helper e mostre os primeiros 10 documentos.

Nach Namen suchen:

Use search_documents do wiki-helper para procurar "autenticação".

Im Wiki suchen:

Use search_content do wiki-helper para pesquisar "JWT", com limite 5.

Ein Dokument lesen:

Use read_document do wiki-helper para ler "caminho/documento.md" e faça um resumo.

Häufige Probleme

Fehler ECONNREFUSED ...:80

Die URL hat keinen Port oder keine Route. Verwenden Sie immer:

http://IP_DO_SERVIDOR:3000/mcp

Route /authorize geöffnet

Der Client hat versucht, OAuth zu verwenden. Dieser MCP hat kein OAuth. Entfernen Sie die Authentifizierung und lassen Sie die Felder Bearer und Headers leer.

Der MCP verbindet nicht

Überprüfen Sie auf dem Server-Rechner:

npm run start:http
ss -lntp | grep 3000

Testen Sie erneut auf dem Client-Rechner:

curl http://IP_DO_SERVIDOR:3000/health

Das Wiki gibt keine Dokumente zurück

Überprüfen Sie, ob der konfigurierte Ordner Markdown-Dateien enthält:

find ./data/wiki -type f -name '*.md' | head

Überprüfen Sie auch den Zugriff auf das in WIKI_REPOSITORY_URL konfigurierte Git-Repository.

Sicherheit

• Verwenden Sie diesen Modus ohne Authentifizierung nur in einem kontrollierten lokalen Netzwerk.

• Setzen Sie den Port 3000 nicht direkt im Internet aus.

• Verwenden Sie für externen Zugriff HTTPS, Authentifizierung und einen Reverse-Proxy.

• Versionieren Sie niemals Schlüssel oder Anmeldedaten in der .env.