opencode-session-context-mcp

osc-mcp

Demo

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

Related MCP server: agent-mem0

Diccionario

• Descripción

• Cómo funciona

• Herramientas

• Requisitos

• Instalación

• Ejecución

• Consejos

• Entorno

• Notas sobre el SO

Descripción

opencode-session-context-mcp (también conocido como osc-mcp) es un servidor MCP que proporciona a las nuevas sesiones contexto de sesiones anteriores en el mismo proyecto, para que tu instancia de OpenCode pueda continuar donde la dejaste y alinearse mejor con las necesidades actuales de tu proyecto.

⚠️ Precaución: esta herramienta está en desarrollo activo, especialmente en lo que respecta a la optimización del consumo de tokens al obtener contexto. Las contribuciones son bienvenidas.

Cómo funciona

• Al iniciar la sesión, el servidor almacena un resumen filtrado de la sesión anterior en mcp.db.

• Cuando una nueva sesión solicita contexto, busca resúmenes recientes para el proyecto actual.

• El cliente (OpenCode) utiliza esos resúmenes para dotar a tu nueva sesión de contexto relevante.

Herramientas

• store_previous_session_content: almacena contenido filtrado de la sesión anterior más reciente en mcp.db.

• get_relevant_sessions: devuelve una lista ligera de resúmenes de sesiones recientes para el proyecto actual.

Requisitos

• bun

• git

• OpenCode (instalado y configurado)

Instalación

Inicio rápido (mejor experiencia de usuario)

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

Nota de seguridad: revisa scripts/install.sh antes de ejecutarlo o utiliza los pasos manuales a continuación. Para Windows, revisa scripts/install.ps1 antes de ejecutarlo.

Qué hace el instalador (Linux/mac):

• Encuentra tu opencode.json (respeta XDG_CONFIG_HOME).

• Verifica que bun y git estén instalados.

• Verifica que el directorio de datos de OpenCode exista (respeta XDG_DATA_HOME).

• Clona o actualiza el repositorio en ~/.local/share/opencode/osc-mcp.

• Ejecuta bun install y compila el servidor.

• Actualiza opencode.json para añadir la entrada MCP "osc-mcp".

• Si la edición de la configuración falla o se establece --no-config, imprime los pasos manuales.

Si tu configuración no es un JSON válido o pasas --no-config, sigue los pasos manuales a continuación.

Instalación manual

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

Configuración de OpenCode (~/.config/opencode/opencode.json):

Si aún no tienes listados los archivos de instrucciones, añádelos:

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

Luego añade la entrada MCP local (si no está presente):

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

Ejecución

# Run the MCP server
bun src/index.ts

Consejos

• Inicia OpenCode desde la raíz de tu proyecto para que el MCP pueda asignar las sesiones al proyecto correcto.

• Mantén tu proyecto en git para que las sesiones puedan vincularse a un contexto de repositorio estable.

Entorno

• OPENCODE_DB: Ruta a la base de datos de OpenCode (por defecto ~/.local/share/opencode/opencode.db)

Si la ruta por defecto no funciona para tu configuración, establécela explícitamente antes de iniciar OpenCode/MCP.

Ejemplo:

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

Sobrescrituras del instalador (opcional):

• OSC_MCP_REPO_URL: URL del repositorio Git a clonar (por defecto https://github.com/vohs-1980/osc-mcp.git).

• OSC_MCP_INSTALL_DIR: Directorio de instalación (por defecto ~/.local/share/opencode/osc-mcp).

• OSC_MCP_REF: Referencia de Git a extraer (etiqueta/rama/commit, por defecto main).

• XDG_CONFIG_HOME: Directorio base de configuración (por defecto ~/.config).

• XDG_DATA_HOME: Directorio base de datos (por defecto ~/.local/share).

Ejemplo de sobrescritura:

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"

Notas sobre el SO

• macOS/Linux: usa scripts/install.sh (requiere bash, git, bun)

• Windows: usa scripts/install.ps1 en PowerShell.

Detección de ruta de configuración (los instaladores buscan en este orden):

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

Ubicaciones de datos por defecto (bases de datos):

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

Licencia

MIT. Consulta LICENSE.