Svelte LLM (MCP-сервер)
Svelte LLM — это сервер, предоставляющий пресеты (шаблоны) для работы LLM с проектами на Svelte 5 и SvelteKit, а также MCP-эндпоинт для интеграции с AI-ассистентами. Позволяет быстро подгружать документацию и контекст из репозиториев GitHub.
Сайт проекта: svelte-llm.stanislav.garden
MCP-эндпоинт
Сервер реализует протокол MCP (Model Context Protocol) для связи с AI-ассистентами. Доступны два типа подключения:
- SSE (Claude Desktop):
https://svelte-llm.stanislav.garden/mcp/sse
- Streamable HTTP (остальные клиенты):
https://svelte-llm.stanislav.garden/mcp/mcp
Установка и запуск
-
Настройка окружения
Создайте файл .env в корневой директории проекта со следующим содержимым:
GITHUB_TOKEN=
DB_URL=postgres://admin:admin@localhost:5432/db
GITHUB_TOKEN — классический GitHub-токен с правами public_repo. Создать можно здесь.
-
Запуск Docker
Убедитесь, что Docker установлен, и выполните:
docker-compose up
-
Установка зависимостей и запуск dev-сервера
nvm use
npm i
npm run dev
-
Миграции базы данных
После запуска dev-сервера откройте в браузере http://localhost:5173/api/migrate для применения миграций.
-
Панель администратора
По адресу http://localhost:5173/admin доступны все скрытые эндпоинты. Пароль по умолчанию — secret.
Поддерживаемые пресеты
Актуальный список пресетов (шаблонов для LLM) доступен на сайте llmctx.com. Каждый пресет связывает определённый репозиторий с набором файлов (например, *.md или *.mdx), которые используются как контекст для AI.
Добавление нового пресета
Чтобы добавить свой пресет в репозиторий:
-
Сделайте форк этого репозитория.
-
Откройте файл src/lib/presets.ts.
-
Добавьте новый элемент в объект presets следующей структуры:
[presetKey]: {
title: 'Название пресета',
owner: 'github-owner',
repo: 'github-repo',
glob: ['**/*.md', '**/*.mdx', '!/excluded/'], // поддерживает glob-паттерны
prompt: 'Опциональный промпт для дополнительного контекста'
}
glob — массив шаблонов для включения/исключения файлов. Поддерживает стандартные glob-паттерны:
**/*.md — все Markdown-файлы в любых поддиректориях.
**/*.mdx — все MDX-файлы.
!pattern — исключение файлов/директорий, подходящих под шаблон.
- Порядок важен: сначала включения, потом исключения.
-
Создайте pull request с вашими изменениями.
Убедитесь, что источник документации надёжен и активно поддерживается.
Отладка MCP
Для локальной отладки MCP-сервера можно использовать официальный инспектор:
NODE_TLS_REJECT_UNAUTHORIZED=0 NODE_OPTIONS="--insecure-http-parser" npx @modelcontextprotocol/inspector
После запуска откройте http://127.0.0.1:6274. Также можно использовать GitHub Copilot в режиме Agent — информацию о настройке см. в .vscode/mcp.json.
Прочее
Комментарии
Комментариев пока нет. Будьте первым.