Agentic PID Tuner (MCP 기반)

**Model Context Protocol (MCP)**와 통합된 대화형 실시간 PID 컨트롤러 대시보드입니다. 이 프로젝트를 사용하면 AI 에이전트(예: Claude)가 자연어 명령을 사용하여 시뮬레이션된 제어 루프를 능동적으로 읽고, 분석하고, 튜닝할 수 있으며, 변경 사항이 웹 브라우저에 즉시 반영됩니다.

✨ 기능

• 실시간 웹 대시보드: UI 슬라이더를 사용하여 $K_p$, $K_i$, $K_d$ 게인을 수동으로 조정할 수 있습니다.

• 실시간 파형 시각화: 오버슈트, 정착 시간, 시스템 응답을 즉시 확인할 수 있습니다(simple-pid 및 matplotlib 기반).

• AI 에이전트 제어: LLM이 현재 게인을 읽고 새 값을 적용할 수 있는 도구를 노출하는 MCP 서버를 포함합니다.

• 양방향 동기화: 슬라이더를 움직이면 AI가 새 값을 확인합니다. AI가 값을 변경하면 브라우저가 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가 대시보드와 상호 작용할 수 있도록 Claude Desktop 구성에 MCP 서버를 추가합니다.

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. AI와 대화하기

Flask 앱이 실행 중인 상태에서 Claude Desktop을 엽니다. 이제 다음과 같은 프롬프트를 사용할 수 있습니다:

• "내 대시보드의 현재 PID 파라미터를 확인해 줘."

• "시스템의 오버슈트가 너무 큽니다. 오버슈트를 5% 미만으로 낮추도록 파라미터를 조정해 줄 수 있나요?"

• "비례 게인을 0.5만큼 높이고 정착 시간에 어떤 영향을 미치는지 알려줘."

Claude가 시스템을 튜닝하는 동안 웹 대시보드가 자동으로 업데이트되는 것을 확인해 보세요!

📂 프로젝트 구조

• app.py: Flask 웹 서버, PID 시뮬레이션 루프, API 엔드포인트를 포함합니다.

• mcp_server_pid.py: 표준 I/O를 통해 LLM에 get_pid_parameters 및 update_pid_parameters 도구를 노출하는 FastMCP 서버입니다.

• requirements.txt: Python 의존성(flask, mcp, simple-pid, matplotlib).