opencode-session-context-mcp

osc-mcp

Демонстрация

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

Related MCP server: agent-mem0

Словарь

• Описание

• Как это работает

• Инструменты

• Требования

• Установка

• Запуск

• Советы

• Окружение

• Примечания по ОС

Описание

opencode-session-context-mcp (также известный как osc-mcp) — это MCP-сервер, который предоставляет новым сессиям контекст из предыдущих сессий в рамках того же проекта, чтобы ваш экземпляр OpenCode мог продолжить работу с того места, где вы остановились, и лучше соответствовать текущим потребностям вашего проекта.

⚠️ Внимание: этот инструмент находится в стадии активной разработки, особенно в части оптимизации расхода токенов при получении контекста. Мы приветствуем любой вклад.

Как это работает

• При запуске сессии сервер сохраняет отфильтрованную сводку предыдущей сессии в mcp.db.

• Когда новая сессия запрашивает контекст, она ищет недавние сводки для текущего проекта.

• Клиент (OpenCode) использует эти сводки, чтобы наполнить вашу новую сессию релевантным контекстом.

Инструменты

• store_previous_session_content: сохраняет отфильтрованный контент из самой последней предыдущей сессии в mcp.db.

• get_relevant_sessions: возвращает облегченный список недавних сводок сессий для текущего проекта.

Требования

• bun

• git

• OpenCode (установлен и настроен)

Установка

Быстрый старт (лучший UX)

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

Примечание по безопасности: перед запуском ознакомьтесь с scripts/install.sh или воспользуйтесь инструкциями ниже. Для Windows перед запуском ознакомьтесь с scripts/install.ps1.

Что делает установщик (Linux/mac):

• Находит ваш opencode.json (учитывает XDG_CONFIG_HOME).

• Проверяет наличие bun и git.

• Проверяет наличие директории данных OpenCode (учитывает XDG_DATA_HOME).

• Клонирует или обновляет репозиторий в ~/.local/share/opencode/osc-mcp.

• Запускает bun install и собирает сервер.

• Обновляет opencode.json, добавляя запись MCP "osc-mcp".

• Если редактирование конфигурации не удалось или установлен флаг --no-config, выводит инструкции для ручной установки.

Если ваш файл конфигурации содержит невалидный JSON или вы используете --no-config, следуйте инструкциям по ручной установке ниже.

Ручная установка

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 (~/.config/opencode/opencode.json):

Если у вас еще не указаны файлы инструкций, добавьте их:

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

Затем добавьте локальную запись MCP (если она отсутствует):

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

Запуск

# Run the MCP server
bun src/index.ts

Советы

• Запускайте OpenCode из корневой директории вашего проекта, чтобы MCP мог сопоставить сессии с нужным проектом.

• Храните проект в git, чтобы сессии могли быть привязаны к стабильному контексту репозитория.

Окружение

• OPENCODE_DB: Путь к БД OpenCode (по умолчанию ~/.local/share/opencode/opencode.db)

Если путь по умолчанию не подходит для вашей настройки, установите его явно перед запуском OpenCode/MCP.

Пример:

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

Переопределения установщика (опционально):

• OSC_MCP_REPO_URL: URL Git-репозитория для клонирования (по умолчанию https://github.com/vohs-1980/osc-mcp.git).

• OSC_MCP_INSTALL_DIR: Директория установки (по умолчанию ~/.local/share/opencode/osc-mcp).

• OSC_MCP_REF: Git-ссылка для checkout (тег/ветка/коммит, по умолчанию main).

• XDG_CONFIG_HOME: Базовая директория конфигурации (по умолчанию ~/.config).

• XDG_DATA_HOME: Базовая директория данных (по умолчанию ~/.local/share).

Пример переопределения:

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"

Примечания по ОС

• macOS/Linux: используйте scripts/install.sh (требуются bash, git, bun)

• Windows: используйте scripts/install.ps1 в PowerShell.

Определение пути к конфигурации (установщики ищут в следующем порядке):

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

Расположение данных по умолчанию (базы данных):

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

Лицензия

MIT. См. LICENSE.