ACE MCP Server

# 🚀 START HERE - ACE MCP Server Setup ## 🎉 Успешно создано! **Локация**: `$HOME/code/perplexity/ace-mcp-server` ## ✅ Что уже готово ``` ace-mcp-server/ ├── ✅ package.json # NPM конфигурация ├── ✅ tsconfig.json # TypeScript настройки ├── ✅ .env.example # Пример переменных окружения ├── ✅ .gitignore # Git ignore ├── ✅ README.md # Описание проекта ├── ✅ INSTALLATION.md # Детальная инструкция ├── ✅ ASSETS_CHECKLIST.md # Чеклист ресурсов ├── ✅ START_HERE.md # Этот файл ├── ✅ src/ # Директория исходников │ ├── ✅ core/ # ACE компоненты │ ├── ✅ mcp/ # MCP протокол │ ├── ✅ storage/ # Хранилище │ └── ✅ utils/ # Утилиты └── ✅ docs/ # Документация └── ✅ COPY_GUIDE.md # Гайд по копированию ``` ## 📂 Что нужно скопировать ### 1. Исходный код TypeScript (13 файлов) **Источник**: Документ **[88]** в чате Perplexity **Название**: "ace-mcp-complete-source.md" #### Быстрый способ: 1. Откройте документ [88] в Perplexity 2. Найдите каждый файл по заголовку "## FILE: ..." 3. Скопируйте код между тройными backticks \`\`\`typescript ... \`\`\` 4. Вставьте в соответствующий файл #### Список файлов для копирования: **Storage (3 файла)** - `src/storage/bullet.ts` - `src/storage/embeddings.ts` - `src/storage/deduplicator.ts` **Core (4 файла)** - `src/core/playbook.ts` - `src/core/generator.ts` - `src/core/reflector.ts` - `src/core/curator.ts` **MCP (2 файла)** - `src/mcp/tools.ts` - `src/mcp/server.ts` **Utils (3 файла)** - `src/utils/config.ts` - `src/utils/logger.ts` - `src/utils/errors.ts` **Entry Point (1 файл)** - `src/index.ts` ### 2. PDF Документация (2 файла) **User Guide** - Документ [85] → сохраните как `docs/USER_GUIDE.pdf` **Admin Guide** - Документ [86] → сохраните как `docs/ADMIN_GUIDE.pdf` ### 3. LinkedIn пост (опционально) **LinkedIn Post** - Документ [42] → сохраните как `docs/linkedin-post.md` ## 🛠️ Быстрая установка (после копирования файлов) ```bash # 1. Перейти в директорию cd $HOME/code/perplexity/ace-mcp-server # 2. Установить зависимости npm install # 3. Собрать проект npm run build # 4. Протестировать npm start ``` ## ⚙️ Настройка Cursor AI Отредактируйте `~/.cursor/mcp.json`: ```json { "mcpServers": { "ace-context-engine": { "command": "node", "args": ["$HOME/code/perplexity/ace-mcp-server/dist/index.js"], "env": { "ACE_CONTEXT_DIR": "$HOME/code/perplexity/ace-mcp-server/contexts", "ACE_LOG_LEVEL": "info", "ACE_DEDUP_THRESHOLD": "0.85" } } } } ``` Перезапустите Cursor AI. ## 🎯 Быстрый тест В Cursor AI: ``` Using ACE, help me create a simple Express.js authentication endpoint ``` ACE должен: 1. ✅ Сгенерировать код используя playbook 2. ✅ Отследить полезные стратегии 3. ✅ Позволить рефлексию 4. ✅ Обновить playbook ## 📚 Подробные инструкции ### Для пользователей ➡️ Читайте `docs/USER_GUIDE.pdf` (скачайте из [85]) ### Для администраторов ➡️ Читайте `docs/ADMIN_GUIDE.pdf` (скачайте из [86]) ### Для разработчиков ➡️ Читайте `README.md` и `INSTALLATION.md` ## 🔗 Быстрые ссылки **В текущем чате Perplexity найдите:** - [42] - LinkedIn Post (англ) - [84] - Web Dashboard (демо) - [85] - User Guide PDF (15 страниц) - [86] - Admin Guide PDF (23 страницы) - [88] - Исходный код TypeScript ## ⚠️ Важно 1. **Скопируйте ВСЕ 13 TypeScript файлов** из документа [88] 2. **Не забудьте** скачать PDF документацию 3. **Проверьте** что `npm run build` выполняется без ошибок 4. **Настройте** Cursor AI перед использованием ## 🐛 Проблемы? ### Build ошибки ```bash # Удалите и переустановите rm -rf node_modules dist npm install npm run build ``` ### MCP сервер не подключается ```bash # Проверьте что файл существует ls dist/index.js # Проверьте Cursor логи # Settings → Developer → View MCP Logs ``` ### Помощь - Читайте `INSTALLATION.md` - детальные инструкции - Читайте `docs/COPY_GUIDE.md` - гайд по копированию - Читайте `ASSETS_CHECKLIST.md` - полный чеклист ## ✨ Что дальше? 1. ✅ Скопируйте исходный код из [88] 2. ✅ Установите зависимости: `npm install` 3. ✅ Соберите проект: `npm run build` 4. ✅ Настройте Cursor AI 5. ✅ Начните использовать ACE! ## 🎆 Особенности - **86.9%** снижение latency адаптации - **+10.6%** точности на agent задачах - Инкрементальные дельта-обновления - Семантическая дедупликация - Само-обучение без размеченных данных - Мульти-контекстная поддержка --- **Статус**: Структура готова ✅ **Следующий шаг**: Скопировать исходники из документа [88] **Создано**: 26 октября 2025 🚀 **Начните с документа [88] - скопируйте все TypeScript файлы!**