# FreshContext

MCP-сервер пересчитывает релевантность документов в RAG с учётом даты публикации. Он отсекает устаревшие данные до того, как они попадут в контекст модели.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Автор: PrinceGabriel-lgtm
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
- Обновлён: 2026-09-30
- HTML: https://affpapa.org/nevibecode/mcp/freshcontext

## Что делает

Обычный семантический поиск сопоставляет текст по векторной близости, игнорируя дату создания статьи. Из-за этого материалы прошлых лет получают такие же высокие оценки, как и свежие публикации. FreshContext встраивается между поисковой базой и агентом, корректируя векторный балл по формуле временного затухания. Для блогов, новостей и научных статей применяются разные коэффициенты угасания.

Основной инструмент сервера — `evaluate_context`. На вход передаются массив найденных фрагментов, профиль задачи и исходные метрики близости. Сервер анализирует дату извлечения, источник и возвращает вердикт с понятным действием, оценкой пригодности и предупреждениями. Выходные данные оформляются в стандартную структуру `[FRESHCONTEXT]`.

Пакет `freshcontext-mcp` зафиксирован на версии 0.5.3, и его разработка автором прекращена. Кодовая база остаётся доступной под лицензией MIT, а подключить сервер можно локально через `npx` или по HTTP через адрес `https://api.freshcontext.dev/mcp`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.freshcontext.dev/mcp`

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http freshcontext https://api.freshcontext.dev/mcp
```

2. **Командой платформы**
```bash
claude mcp add freshcontext -- npx -y freshcontext-mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add freshcontext --url https://api.freshcontext.dev/mcp
```

2. **Командой платформы**
```bash
codex mcp add freshcontext -- npx -y freshcontext-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freshcontext": {
            "url": "https://api.freshcontext.dev/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "freshcontext": {
            "command": "npx",
            "args": [
                "-y",
                "freshcontext-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "freshcontext": {
            "type": "http",
            "url": "https://api.freshcontext.dev/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "freshcontext": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "freshcontext-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http freshcontext https://api.freshcontext.dev/mcp
```

2. **Командой платформы**
```bash
gemini mcp add freshcontext npx -y freshcontext-mcp
```

## Когда брать
- Отфильтровать устаревшие статьи и записи в результатах RAG
- Скорректировать векторную релевантность с учётом времени публикации
- Получить структурированное обоснование надёжности каждого источника
- Проверить готовность контекста перед отправкой в модель

## Примеры запросов агенту
- Оцени свежесть найденных статей через `evaluate_context` перед формированием ответа.
- Проверь список ссылок на актуальность, используя профиль `citation_check`.
- Отсортируй контекст по формуле временного затухания и покажи предупреждения.

## Похожие
- [rag-engineer](https://affpapa.org/nevibecode/skills/sickn33-rag-engineer.md) — скилл · 1000 установок
- [evaluate-rag](https://affpapa.org/nevibecode/skills/evaluate-rag.md) — скилл · 970 установок
- [prompt-engineering](https://affpapa.org/nevibecode/skills/neolabhq-prompt-engineering.md) — скилл · 1400 установок
- [llm-context](https://affpapa.org/nevibecode/skills/llm-context.md) — скилл · 1300 установок
- [rag](https://affpapa.org/nevibecode/skills/rag.md) — скилл · 3700 установок
- [rag-architect](https://affpapa.org/nevibecode/skills/rag-architect.md) — скилл · 629 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md