Agentic PID Tuner (via MCP)

Интерактивная панель управления PID-регулятором в реальном времени, интегрированная с Model Context Protocol (MCP). Этот проект позволяет ИИ-агентам (например, Claude) активно считывать, анализировать и настраивать симулированный контур управления с помощью команд на естественном языке, при этом изменения мгновенно отражаются в веб-браузере.

✨ Возможности

• Веб-панель в реальном времени: Регулируйте коэффициенты $K_p$, $K_i$ и $K_d$ вручную с помощью слайдеров интерфейса.

• Визуализация сигналов в реальном времени: Перерегулирование, время установления и реакция системы видны мгновенно (на базе simple-pid и matplotlib).

• Управление с помощью ИИ-агента: Включает MCP-сервер, который предоставляет инструменты для LLM, позволяющие считывать текущие коэффициенты и задавать новые.

• Двусторонняя синхронизация: Если вы перемещаете слайдер, ИИ видит новое значение. Если ИИ изменяет значение, ваш браузер автоматически обновляется в течение 1 секунды.

Related MCP server: agentic-mcp-server

🛠️ Предварительные требования

• Python 3.8+

• Claude или Cursor Desktop App (для интеграции с MCP)

🚀 Установка

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

gh repo clone SuriyaMurthy/agentic-pid-controller
cd agentic-pid-controller

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

python -m venv .venv

# On Windows:
.venv\Scripts\activate
# On Mac/Linux:
source .venv/bin/activate

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

pip install -r requirements.txt

🎮 Использование

1. Запуск веб-панели

Запустите Flask-сервер для обслуживания симуляции и веб-интерфейса:

python app.py

Откройте браузер и перейдите по адресу http://127.0.0.1:5000.

2. Подключение к Claude Desktop (MCP)

Чтобы Claude мог взаимодействовать с вашей панелью, добавьте MCP-сервер в конфигурацию Claude Desktop.

Откройте файл конфигурации Claude Desktop:

• Linux: ~/.cursor/mcp.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте следующую конфигурацию. ВАЖНО: Вы должны заменить их на реальные полные пути на вашем компьютере!

{
  "mcpServers": {
    "pid_controller": {
      "command": "/absolute/path/to/mcp-pid-tuner/.venv/bin/python3",
      "args": [
        "/absolute/path/to/mcp-pid-tuner/mcp_server_pid.py"
      ]
    }
  }
}

Примечание для пользователей Windows: используйте путь к вашему .venv\Scripts\python.exe и убедитесь, что обратные слэши экранированы (\\).

Перезапустите Claude Desktop после сохранения файла.

3. Общение с ИИ

При запущенном Flask-приложении откройте Claude Desktop. Теперь вы можете использовать такие запросы, как:

• «Проверьте текущие параметры PID на моей панели.»

• «В системе слишком большое перерегулирование. Можете скорректировать параметры, чтобы снизить перерегулирование ниже 5%?»

• «Увеличьте пропорциональный коэффициент на 0,5 и расскажите, как это повлияет на время установления.»

Наблюдайте, как веб-панель автоматически обновляется, пока Claude настраивает систему!

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

• app.py: Flask-веб-сервер, цикл симуляции PID и API-эндпоинты.

• mcp_server_pid.py: FastMCP-сервер, который предоставляет инструменты get_pid_parameters и update_pid_parameters для LLM через стандартный ввод-вывод.

• requirements.txt: Python-зависимости (flask, mcp, simple-pid, matplotlib).