Context Portal MCP

Установка

Работает в

• Roo Code
• Cline
• Windsurf
• Cursor
• SourceCraft
• Koda
• Coddy

npx skillfoxx add mcp/context-portal

Что делает

Context Portal, или ConPort, — MCP-сервер на Python, который ведет для каждого рабочего каталога банк памяти проекта. База SQLite создается автоматически в папке `context_portal/`, а рядом лежит векторное хранилище на ChromaDB. Агент записывает в нее решения с обоснованием, статусы задач, архитектурные паттерны и произвольные данные вроде глоссария, а потом достает их полнотекстовым и семантическим поиском. Векторы строит локальная модель `all-MiniLM-L6-v2` из пакета `sentence-transformers`. Записи связываются между собой инструментом `link_conport_items`, из связей складывается граф знаний проекта. Контекст продукта и текущий рабочий контекст хранятся с историей версий, `get_item_history` возвращает прошлые состояния. Инструмент `get_recent_activity_summary` собирает недавние изменения, `batch_log_items` записывает пачку решений или задач за один вызов, а `export_conport_to_markdown` и `import_markdown_to_conport` переносят данные в Markdown-файлы и обратно. Схема базы обновляется миграциями Alembic. Каждый вызов получает `workspace_id`, поэтому один сервер обслуживает несколько проектов. Если путь не задан при запуске, ConPort ищет корень проекта сам по `.git`, `package.json`, `pyproject.toml` и другим признакам. Репозиторий содержит инструкции для агентов под Roo Code, Cline, Windsurf Cascade и универсальный вариант: их вставляют в системный промпт, чтобы агент сам загружал и обновлял память.

Для кого. Для разработчиков, которые работают с Roo Code, Cline, Windsurf или Cursor и хотят, чтобы агент хранил решения и ход работы в базе проекта.

Пример запроса к агенту

Запиши в ConPort решение: для очереди задач берем Redis, потому что он уже есть в проекте, и свяжи его с задачей про фоновые отправки писем

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

• Лицензия Apache-2.0. В манифесте версия 0.3.13 и классификатор «Beta».
• В тексте инструкции сказано «Python 3.8 или выше», но манифест требует 3.10 и новее, ориентируйтесь на манифест.
• Многие редакторы не раскрывают `${workspaceFolder}` при запуске сервера. Автор советует указывать абсолютный путь в `--workspace_id` или не задавать его при запуске и передавать в каждом вызове. Если IDE подставит буквальную строку `${workspaceFolder}`, ConPort игнорирует ее и ищет корень сам.
• Без инструкций для агента память не наполняется: сервер только отвечает на вызовы. Агентам Windsurf Cascade в новой сессии нужно прямо сказать «Initialize according to custom instructions».
• При обновлении между версиями со сменой схемы базы автор советует прочитать `v0.2.4_UPDATE_GUIDE.md`: иногда данные нужно переносить через экспорт и импорт вручную.

Как отключить. Удалите запись `conport` из настроек MCP в клиенте (в примере из инструкции это `mcp_settings.json`). Данные останутся в папке `context_portal/` рабочего каталога, ее можно удалить вручную. Перед удалением при желании выгрузите память в Markdown инструментом `export_conport_to_markdown`.

Коротко о README

Главная страница объясняет, что такое ConPort, и перечисляет возможности: SQLite на рабочий каталог, векторное хранилище, граф знаний и миграции Alembic. Дальше идут требования, настройка через `uvx` и вариант для разработчиков из клона, раздел об инструкциях для агентов, автоопределение рабочего каталога и справочник из примерно тридцати инструментов с аргументами. В репозитории лежат углубленный разбор `conport_mcp_deep_dive.md`, руководство по обновлению, Dockerfile, правила участия и тесты обработчиков.