opencode-session-context-mcp

osc-mcp

Demo

https://github.com/user-attachments/assets/d41fb2b8-96ca-4a03-9bcd-afede68212e2

Related MCP server: agent-mem0

Inhaltsverzeichnis

• Beschreibung

• Funktionsweise

• Tools

• Anforderungen

• Installation

• Ausführung

• Tipps

• Umgebung

• Betriebssystem-Hinweise

Beschreibung

opencode-session-context-mcp (auch bekannt als osc-mcp) ist ein MCP-Server, der neue Sitzungen mit Kontext aus früheren Sitzungen desselben Projekts versorgt, sodass Ihre OpenCode-Instanz dort weitermachen kann, wo Sie aufgehört haben, und besser auf die laufenden Anforderungen Ihres Projekts abgestimmt ist.

⚠️ Achtung: Dieses Tool befindet sich in aktiver Entwicklung, insbesondere im Hinblick auf die Optimierung des Token-Verbrauchs beim Abrufen von Kontext. Beiträge sind willkommen.

Funktionsweise

• Beim Start einer Sitzung speichert der Server eine gefilterte Zusammenfassung der vorherigen Sitzung in mcp.db.

• Wenn eine neue Sitzung Kontext anfordert, sucht sie nach aktuellen Zusammenfassungen für das aktuelle Projekt.

• Der Client (OpenCode) verwendet diese Zusammenfassungen, um Ihre neue Sitzung mit relevantem Kontext zu initialisieren.

Tools

• store_previous_session_content: speichert gefilterte Inhalte aus der letzten vorherigen Sitzung in mcp.db.

• get_relevant_sessions: gibt eine leichtgewichtige Liste aktueller Sitzungszusammenfassungen für das aktuelle Projekt zurück.

Anforderungen

• bun

• git

• OpenCode (installiert und konfiguriert)

Installation

Schnellstart (beste Benutzererfahrung)

Linux/mac

curl -fsSL https://github.com/vohs-1980/osc-mcp/blob/main/scripts/install.sh?raw=1 | bash

Windows (PowerShell):

irm https://github.com/vohs-1980/osc-mcp/blob/main/scripts/install.ps1?raw=1 | iex

Sicherheitshinweis: Überprüfen Sie scripts/install.sh, bevor Sie es ausführen, oder verwenden Sie die manuellen Schritte unten. Überprüfen Sie für Windows scripts/install.ps1, bevor Sie es ausführen.

Was das Installationsprogramm tut (Linux/mac):

• Findet Ihre opencode.json (berücksichtigt XDG_CONFIG_HOME).

• Überprüft, ob bun und git installiert sind.

• Überprüft, ob das OpenCode-Datenverzeichnis existiert (berücksichtigt XDG_DATA_HOME).

• Klonen oder Aktualisieren des Repos in ~/.local/share/opencode/osc-mcp.

• Führt bun install aus und baut den Server.

• Aktualisiert opencode.json, um den Eintrag "osc-mcp" MCP hinzuzufügen.

• Wenn die Konfigurationsbearbeitung fehlschlägt oder --no-config gesetzt ist, werden die manuellen Schritte ausgegeben.

Wenn Ihre Konfiguration kein gültiges JSON ist oder Sie --no-config übergeben, folgen Sie den manuellen Schritten unten.

Manuelle Installation

git clone https://github.com/vohs-1980/osc-mcp.git \
  ~/.local/share/opencode/osc-mcp
cd ~/.local/share/opencode/osc-mcp
bun install
bun run build

OpenCode-Konfiguration (~/.config/opencode/opencode.json):

Wenn Sie die Anweisungsdateien noch nicht aufgelistet haben, fügen Sie sie hinzu:

"instructions": [
  "~/.local/share/opencode/osc-mcp/instructions/session-start.md",
  "~/.local/share/opencode/osc-mcp/instructions/context-lookup.md"
]

Fügen Sie dann den lokalen MCP-Eintrag hinzu (falls nicht vorhanden):

"osc-mcp": {
  "type": "local",
  "enabled": true,
  "command": ["bun", "~/.local/share/opencode/osc-mcp/src/index.ts"]
}

Ausführung

# Run the MCP server
bun src/index.ts

Tipps

• Starten Sie OpenCode von Ihrem Projektstammverzeichnis aus, damit das MCP Sitzungen dem richtigen Projekt zuordnen kann.

• Behalten Sie Ihr Projekt in Git, damit Sitzungen mit einem stabilen Repo-Kontext verknüpft werden können.

Umgebung

• OPENCODE_DB: Pfad zur OpenCode-Datenbank (Standard ~/.local/share/opencode/opencode.db)

Wenn der Standardpfad für Ihr Setup nicht funktioniert, legen Sie ihn explizit fest, bevor Sie OpenCode/MCP starten.

Beispiel:

export OPENCODE_DB="$HOME/.local/share/opencode/opencode.db"
opencode

Überschreibungen für das Installationsprogramm (optional):

• OSC_MCP_REPO_URL: Git-Repo-URL zum Klonen (Standard https://github.com/vohs-1980/osc-mcp.git).

• OSC_MCP_INSTALL_DIR: Installationsverzeichnis (Standard ~/.local/share/opencode/osc-mcp).

• OSC_MCP_REF: Git-Referenz zum Auschecken (Tag/Branch/Commit, Standard main).

• XDG_CONFIG_HOME: Basis-Konfigurationsverzeichnis (Standard ~/.config).

• XDG_DATA_HOME: Basis-Datenverzeichnis (Standard ~/.local/share).

Beispiel für eine Überschreibung:

export OSC_MCP_REPO_URL="https://github.com/vohs-1980/osc-mcp.git"
export OSC_MCP_INSTALL_DIR="$HOME/.local/share/opencode/osc-mcp"
export OSC_MCP_REF="v0.1.0"
export XDG_CONFIG_HOME="$HOME/.config"
export XDG_DATA_HOME="$HOME/.local/share"

Betriebssystem-Hinweise

• macOS/Linux: Verwenden Sie scripts/install.sh (erfordert bash, git, bun)

• Windows: Verwenden Sie scripts/install.ps1 in PowerShell.

Erkennung des Konfigurationspfads (Installationsprogramme suchen in dieser Reihenfolge):

macOS/Linux:

1. $XDG_CONFIG_HOME/opencode/opencode.json

2. ~/.config/opencode/opencode.json

3. ~/Library/Application Support/opencode/opencode.json

Windows:

1. %XDG_CONFIG_HOME%\opencode\opencode.json

2. %APPDATA%\opencode\opencode.json

3. %LOCALAPPDATA%\opencode\opencode.json

4. ~\.config\opencode\opencode.json

5. ~\Library\Application Support\opencode\opencode.json

Standard-Datenspeicherorte (Datenbanken):

macOS/Linux:

• ~/.local/share/opencode/opencode.db

• ~/.local/share/opencode/osc-mcp/mcp.db

Windows:

• %USERPROFILE%\.local\share\opencode\opencode.db

• %USERPROFILE%\.local\share\opencode\osc-mcp\mcp.db

Lizenz

MIT. Siehe LICENSE.