ClearPath Learning MCP

ClearPath Learning MCP — это учебный проект для начинающих, ориентированный на технические темы. Он включает публичный веб-сайт, размещённое рабочее пространство для учащихся и автономный пакет MCP, который превращает техническую тему в четыре полезные части: Что это такое, Аналогия из реального мира, Пример и Попробуйте.

Проект предназначен для людей, изучающих Python, безопасность, DevOps, веб-разработку, базы данных, сети и смежные темы. Уроки по безопасности намеренно ограничены оборонительными, законными и локально разрешёнными учебными примерами.

Project map

Related MCP server: hello-mcp-server

Quick start

Используйте Node.js 20 или новее и pnpm 10 или новее.

pnpm install
pnpm dev

Публичный сайт продукта доступен по адресу /, а размещённый учащийся — по адресу /learn. Запустите набор проверок перед открытием pull request:

pnpm check
pnpm test

Local MCP package

Автономный пакет находится в packages/clearpath-learning-mcp. Он намеренно отделён от размещённого веб-сайта, чтобы разработчики могли устанавливать и запускать его из любого MCP-совместимого настольного клиента или проекта.

cd packages/clearpath-learning-mcp
npm install
npm run build
npm test

Локальный пакет требует, чтобы каждый пользователь настроил свой собственный ключ провайдера, совместимого с OpenAI. Полный пример конфигурации клиента см. в README пакета и в справочнике по конфигурации. Никогда не коммитьте ключи провайдера, тестовые учётные данные или файлы .env.

Open-source community

Этот проект распространяется под лицензией MIT. Пожалуйста, прочтите руководство по внесению вклада, кодекс поведения и политику безопасности перед участием.

Release ownership

Локальный пакет настроен для публичного выпуска npm, но не указывает учётную запись реестра или URL репозитория. Перед публикацией сопровождающий должен установить эти значения, создать публичный канал поддержки и выполнить контрольный список выпуска.