Agentic PID Tuner (via MCP)

Model Context Protocol (MCP) と統合された、インタラクティブでリアルタイムのPIDコントローラーダッシュボードです。このプロジェクトにより、AIエージェント（Claudeなど）は自然言語コマンドを使用してシミュレーションされた制御ループを能動的に読み取り、分析し、調整することができ、変更はWebブラウザに即座に反映されます。

✨ 特徴

• リアルタイムWebダッシュボード: 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. Webダッシュボードを起動する

シミュレーションとWebインターフェースをホストする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. AIと対話する

Flaskアプリを起動した状態で、Claude Desktopを開きます。次のようなプロンプトを使用できます:

• "ダッシュボードの現在のPIDパラメータを確認してください。"

• "システムのオーバーシュートが大きすぎます。オーバーシュートを5%未満にするようにパラメータを調整できますか？"

• "比例ゲインを0.5上げて、整定時間にどのような影響があるか教えてください。"

Claudeがシステムを調整するにつれて、Webダッシュボードが自動的に更新される様子を確認してください！

📂 プロジェクト構造

• app.py: Flask Webサーバー、PIDシミュレーションループ、およびAPIエンドポイント。

• mcp_server_pid.py: 標準I/Oを介して get_pid_parameters と update_pid_parameters ツールをLLMに公開するFastMCPサーバー。

• requirements.txt: Pythonの依存関係（flask、mcp、simple-pid、matplotlib）。