DevIntel — ИИ-ассистент для анализа репозиториев

ИИ-ассистент для разработки ПО, который анализирует локальные репозитории с помощью Groq, MCP, Python и Gradio.

DevIntel позволяет разработчикам задавать вопросы о локальном репозитории и автоматически выбирает подходящий MCP-инструмент для получения необходимой информации.

Возможности

• Анализ локальных репозиториев

• Изучение структуры проекта

• Определение технологий и зависимостей

• Поиск по файлам и коду репозитория

• Чтение отдельных файлов репозитория

• Просмотр доступных тестов

• Проверка статуса Git

• Просмотр истории Git

• Просмотр изменений Git

• Задавайте вопросы через диалоговый ИИ-интерфейс

• Автоматический выбор MCP-инструмента

Related MCP server: architectos

Архитектура

                    User
                      │
                      ▼
                ┌───────────┐
                │  Gradio   │
                │    UI     │
                └─────┬─────┘
                      │
                      ▼
                ┌───────────┐
                │   Groq    │
                │    LLM    │
                └─────┬─────┘
                      │
              Tool Selection
                      │
                      ▼
                ┌───────────┐
                │ MCP Client│
                └─────┬─────┘
                      │
                      ▼
                ┌───────────┐
                │ MCP Server│
                └─────┬─────┘
                      │
          ┌───────────┴───────────┐
          │                       │
          ▼                       ▼
    MCP Repository Tools    Local Repository

Как это работает

1. Пользователь указывает путь к локальному репозиторию.

2. Пользователь задаёт вопрос о репозитории.

3. Groq обрабатывает запрос и определяет, какой MCP-инструмент требуется.

4. MCP-клиент отправляет запрос инструмента на MCP-сервер.

5. MCP-сервер выполняет операцию над локальным репозиторием.

6. Результат возвращается LLM.

7. LLM формирует краткий ответ.

8. Ответ отображается в интерфейсе Gradio.

🔧 MCP-инструменты

DevIntel в настоящее время предоставляет 9 MCP-инструментов:

🛠️ Технологический стек

• Python

• Groq API

• GPT-OSS

• Model Context Protocol (MCP)

• Gradio

• AsyncIO

• python-dotenv

Структура проекта

devintel-mcp/
│
├── server.py
├── agent.py
├── ui.py
├── requirements.txt
├── .env.example
├── .gitignore
└── README.md

server.py

Содержит MCP-сервер и инструменты анализа репозитория.

agent.py

Содержит агент DevIntel для командной строки и логику MCP-клиента.

ui.py

Предоставляет веб-интерфейс Gradio и связывает пользователя с ИИ-агентом.

Установка

Клонируйте репозиторий:

git clone https://github.com/marames25/devintel-mcp.git
cd devintel-mcp

Создайте виртуальное окружение:

python -m venv .venv

Активируйте его в Windows:

.venv\Scripts\activate

Установите зависимости:

pip install -r requirements.txt

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

Создайте файл .env:

GROQ_API_KEY=your_groq_api_key

Никогда не коммитьте файл .env.

Убедитесь, что .gitignore содержит:

.env
.venv/
__pycache__/

Запуск DevIntel

Командная строка

python agent.py

Интерфейс Gradio

python ui.py

Затем откройте локальный URL-адрес Gradio, показанный в терминале.

Примеры запросов

После ввода пути к репозиторию вы можете спросить:

What technologies does this project use?

Show me the project structure.

What tests are implemented?

Show me the current Git status.

Read README.md.

Where is the login functionality implemented?

Give me a technical overview of this project.

Пример работы агента

Для:

Show me the project structure.

DevIntel может выполнить:

User
  ↓
Groq
  ↓
project_structure
  ↓
MCP Server
  ↓
Local Repository
  ↓
Tool Result
  ↓
Groq
  ↓
Answer

Важно то, что LLM не имеет прямого доступа к репозиторию. Он запрашивает информацию через доступные MCP-инструменты, а операции с репозиторием выполняет MCP-сервер.

Назначение

DevIntel демонстрирует, как LLM можно подключить к инструментам разработчика через MCP, чтобы создать интеллектуального ассистента для разработки ПО.

Вместо ручной навигации по репозиторию разработчики могут взаимодействовать со своей кодовой базой на естественном языке.

Планы по улучшению

• Индексация и кэширование репозитория

• Анализ качества кода

• Обнаружение уязвимостей в зависимостях

• Анализ pull request'ов

• Автоматические предложения тестов

• Генерация документации кода

• Поддержка удалённых Git-репозиториев

• Более продвинутый анализ архитектуры ПО