START_HERE.md•6.54 kB
# 🚀 START HERE - ACE MCP Server Setup
## 🎉 Успешно создано!
**Локация**: `/Users/ug/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 /Users/ug/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": ["/Users/ug/code/perplexity/ace-mcp-server/dist/index.js"],
"env": {
"ACE_CONTEXT_DIR": "/Users/ug/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 файлы!**