AI Ops Hub

MCP-сервер с RAG для операционных задач разработчика.

Что это

AI Ops Hub — это MCP (Model Context Protocol) сервер, который предоставляет ИИ-клиентам безопасный доступ к:

• Локальным заметкам и документам
• Веб-страницам (с очисткой)
• RAG-поиску по личному корпусу
• Инструментам для создания задач и заметок

Установка

# Установка зависимостей
npm install

# Или с pnpm
pnpm install

Разработка

# Запуск в режиме разработки
npm run dev

# Сборка
npm run build

# Тесты
npm test

Конфигурация

База данных (SQLite в Docker)

# Запуск SQLite контейнера
./scripts/db.sh start

# Инициализация базы данных
./scripts/db.sh init

# Проверка статуса
./scripts/db.sh status

# Остановка
./scripts/db.sh stop

Переменные окружения

Создайте файл .env в корне проекта:

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:

{
  "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 сервер:

# Запуск HTTP сервера
npm run start:http

# Или через Docker
docker-compose --profile app up -d

Затем используйте HTTP API:

# Проверка здоровья
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
• [ ] Аудит и логирование

Тестирование

# Сборка проекта
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 - безопасное получение веб-страниц

Все сервисы работают с проверкой безопасности и логированием операций.