MemAura Qoder MCP

Ein eigenständiger Adapter, der MemAura/OmniMemory in Qoder CN integriert. Er verändert weder das ursprüngliche DeepSeek Harness-Projekt /Users/azhai/memaura-mcp-server noch hängt er von ihm ab.

Funktionen

• MCP: store_memory, search_memory, search_memory_hybrid

• Hook: Vor jedem Absenden einer Frage automatischer Hybrid-Abruf; nach Beendigung der Antwort automatisches Speichern dieser Frage-Antwort-Runde.

• Speicher-Geräte-ID konfigurierbar: Standard ist qoder-agent, kann aber auf eine Geräte-ID geändert werden, die mit anderen Clients geteilt wird.

Related MCP server: LedgerMem MCP Server

1. Abhängigkeiten installieren

git clone https://github.com/Omnimemory/omnin-Qoder-mcp.git
cd omnin-Qoder-mcp
./install.sh

install.sh erstellt die .venv dieses Projekts und verändert nicht das System-Python.

2. Lokale Umgebung konfigurieren

cp .env.example .env

Bearbeiten Sie .env und füllen Sie mindestens Folgendes aus:

MEMAURA_API_KEY=你的真实APIKey
MEMAURA_DEFAULT_DEVICE_NO=qoder-agent

.env wird von .gitignore ignoriert. Übertragen Sie den API-Key nicht auf GitHub.

Wenn Sie den Speicher mit DeepSeek Harness teilen möchten, ändern Sie die Geräte-ID auf den dort verwendeten Wert, z. B. dsh-agent; mit qoder-agent ist der Speicher isoliert.

3. Qoder MCP konfigurieren

Öffnen Sie in Qoder unter „Einstellungen → MCP-Dienste“ die Datei mcp.json und konfigurieren Sie sie mit absoluten Pfaden:

{
  "mcpServers": {
    "memaura": {
      "type": "stdio",
      "command": "/绝对路径/omnin-Qoder-mcp/.venv/bin/python",
      "args": ["/绝对路径/omnin-Qoder-mcp/mcp_server.py"],
      "env": {
        "MEMAURA_API_KEY": "你的真实APIKey",
        "MEMAURA_DEFAULT_DEVICE_NO": "qoder-agent",
        "MEMAURA_DEFAULT_TOP_K": "10",
        "MEMAURA_TIMEOUT": "30"
      }
    }
  }
}

Ersetzen Sie die beiden „absoluten Pfade“ durch die tatsächlichen Pfade auf diesem Rechner. Speichern Sie die Änderungen und starten Sie Qoder vollständig neu. Die MCP-Seite sollte drei Werkzeuge anzeigen.

4. Automatischen Abruf und Speichern aktivieren

Qoders MCP-Konfiguration löst die Werkzeuge nicht automatisch aus. Die Hook-Konfiguration befindet sich unter hooks/hooks.json. Führen Sie die folgende hooks-Konfiguration in ~/.lingma/settings.json zusammen (überschreiben Sie nicht Ihre vorhandenen anderen Einstellungen):

{
  "hooks": {
    "UserPromptSubmit": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "/绝对路径/omnin-Qoder-mcp/hooks/run-memory-hook.sh",
        "timeout": 25
      }]
    }],
    "Stop": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "/绝对路径/omnin-Qoder-mcp/hooks/run-memory-hook.sh",
        "timeout": 25,
        "async": true
      }]
    }]
  }
}

Der Hook dieses Projekts liest automatisch die .env im selben Verzeichnis, daher ist keine Abhängigkeit von launchctl erforderlich. Beenden Sie Qoder nach der Änderung vollständig und öffnen Sie es erneut.

5. Überprüfung

Verifizieren Sie zuerst, dass der Hook die Konfiguration lesen kann:

printf '%s' '{"hook_event_name":"UserPromptSubmit","session_id":"test-001","prompt":"测试记忆 QODER-HOOK-918273"}' | hooks/run-memory-hook.sh

Erstellen Sie dann in Qoder einen neuen Chat:

我刚刚购买了一台测试设备，序列号是 DEVICE-XK-591。

Warten Sie 30–60 Sekunden, erstellen Sie einen weiteren Chat und fragen Sie:

我刚刚购买的测试设备序列号是什么？

Wenn DEVICE-XK-591 beantwortet werden kann, sind Speichern und Abruf über Chats hinweg wirksam.

Plugin-Paket veröffentlichen

Das Plugin-Paket muss eine ZIP-Datei sein, und das ZIP-Stammverzeichnis muss direkt .qoder-plugin/plugin.json enthalten. Legen Sie .venv, .env oder den API-Key nicht in das Archiv:

zip -qr memaura-qoder.zip . \
  -x './.venv/*' './.env' './**/__pycache__/*' './*.pyc'

Wählen Sie in Qoder unter „Plugins → Importieren“ die erzeugte ZIP-Datei und nicht den Quellcode-Ordner. Nach der Installation müssen Sie weiterhin wie oben beschrieben die lokale Python-Umgebung und den API-Key konfigurieren.

Fehlerbehebung

• MCP zeigt die Werkzeuge, speichert aber nicht automatisch: Der Hook ist nicht geladen. Überprüfen Sie ~/.lingma/settings.json und starten Sie Qoder neu.

• Der Hook gibt MEMAURA_API_KEY 未设置 aus: Stellen Sie sicher, dass sich .env im Projektstammverzeichnis befindet und der Variablenname korrekt geschrieben ist.

• Manueller store_memory-Aufruf erfolgreich, automatischer Test fehlgeschlagen: MCP funktioniert einwandfrei; das Problem liegt nur in der Hook-Konfiguration oder der Hook-Umgebung.

• Nach erfolgreichem Speichern ist kein sofortiger Abruf möglich: Nach dem Einreihen in die Warteschlange benötigt MemAura normalerweise 30–60 Sekunden, um den Index aufzubauen.