README.md•3.86 kB
# AI Ops Hub
MCP-сервер с RAG для операционных задач разработчика.
## Что это
AI Ops Hub — это MCP (Model Context Protocol) сервер, который предоставляет ИИ-клиентам безопасный доступ к:
- Локальным заметкам и документам
- Веб-страницам (с очисткой)
- RAG-поиску по личному корпусу
- Инструментам для создания задач и заметок
## Установка
```bash
# Установка зависимостей
npm install
# Или с pnpm
pnpm install
```
## Разработка
```bash
# Запуск в режиме разработки
npm run dev
# Сборка
npm run build
# Тесты
npm test
```
## Конфигурация
### База данных (SQLite в Docker)
```bash
# Запуск SQLite контейнера
./scripts/db.sh start
# Инициализация базы данных
./scripts/db.sh init
# Проверка статуса
./scripts/db.sh status
# Остановка
./scripts/db.sh stop
```
### Переменные окружения
Создайте файл `.env` в корне проекта:
```bash
NOTES_DIR=./notes
TASKS_FILE=./tasks.md
RAG_DB_PATH=./data/rag.db
WEB_ALLOWED_HOSTS=example.com,developer.mozilla.org
```
## Подключение к Claude Desktop
### Локальное подключение (stdio)
Добавьте в конфигурацию Claude Desktop:
```json
{
"mcpServers": {
"ai-ops-hub": {
"command": "node",
"args": ["./dist/server.js"],
"env": {
"NOTES_DIR": "/path/to/your/notes",
"RAG_DB_PATH": "/path/to/your/rag.db"
}
}
}
}
```
### Удаленное подключение (HTTP)
Для удаленного доступа запустите HTTP сервер:
```bash
# Запуск HTTP сервера
npm run start:http
# Или через Docker
docker-compose --profile app up -d
```
Затем используйте HTTP API:
```bash
# Проверка здоровья
curl http://localhost:3333/health
# Список инструментов
curl http://localhost:3333/tools
# Вызов инструмента
curl -X POST http://localhost:3333/call \
-H "Content-Type: application/json" \
-d '{"name":"file_read","arguments":{"path":"test-note.md"}}'
```
## Статус разработки
✅ **MVP готова** - базовая функциональность работает
- [x] Базовая структура проекта
- [x] MCP сервер (stdio)
- [x] RAG модуль (заглушка)
- [x] Интеграции (файлы, веб, задачи)
- [x] SQLite база данных в Docker
- [x] Безопасность файлов и веб-запросов
- [x] HTTP транспорт
- [ ] Полная RAG интеграция с SQLite
- [ ] Аудит и логирование
## Тестирование
```bash
# Сборка проекта
npm run build
# Запуск тестов сервисов
node test/test-services.js
# Запуск HTTP API тестов
npm run test:http
# Запуск unit тестов (когда будут готовы)
npm test
```
## Демонстрация
После запуска тестов вы увидите:
1. **FileService** - чтение файлов и безопасность путей
2. **TaskService** - создание и управление задачами
3. **RAGService** - базовая структура для поиска документов
4. **WebService** - безопасное получение веб-страниц
Все сервисы работают с проверкой безопасности и логированием операций.