KETI FLOW MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@KETI FLOW MCP what is the optimal blower angle for a flow of 500?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
KETI FLOW MCP
송풍기/펌프 운전점 데이터를 서버 시작 시마다 학습하고, 에이전트가 MCP tool로 최적 제어값을 조회할 수 있게 하는 독립 MCP 서버입니다.
구조
KETI_FLOW_MCP/
├─ src/
│ ├─ train/
│ ├─ mcp_server/
│ └─ utils/
├─ data/
├─ tests/
├─ config/
│ └─ config.json
├─ main.py
├─ pyproject.toml
├─ uv.lock
├─ README.md
└─ .gitignoresrc/mcp/는 Python MCP SDK의 mcp 패키지명과 충돌할 수 있어 사용하지 않습니다.
Related MCP server: GridWatch MCP
설치
cd C:\Users\keti\workspace\KETI_FLOW_MCP
uv sync가상환경은 .venv/에 생성됩니다.
데이터
학습 데이터는 data/ 아래에 둡니다. 이 폴더는 기밀 데이터 위치이므로 git에서 추적하지 않습니다.
기본 설정은 다음 파일을 사용합니다.
data/blower/fan_training.csv
data/pump/pump_training.csv기본 CSV 컬럼은 다음과 같습니다.
Flowrate,Head,Power,Angle,Speed현재 MCP tool은 요구 유량 Flowrate를 입력받아 Power가 최소가 되는 Angle 값을 찾습니다.
설정
설정 파일은 config/config.json입니다.
주요 항목:
data.base_dir: 학습 데이터 기준 폴더machines.<name>.data_file: 장비별 CSV 경로flow_column: 유량 컬럼control_column: 최적화할 제어값 컬럼target_column: 최소화 또는 최대화할 목표 컬럼optimization:minimize또는maximizecandidate_count: 실시간 탐색 후보 개수respect_control_flow_range: 제어값별 학습 유량 범위를 엄격히 적용할지 여부
실행
uv run python main.py서버는 실행 시 다음 순서로 동작합니다.
config/config.json로딩data/의 CSV 로딩송풍기/펌프 모델 메모리 학습
MCP stdio 서버 시작
모델 파일과 LUT 파일은 생성하지 않습니다.
MCP Tools
get_optimal_blower_angle
입력:
{
"required_flow": 500.0
}응답 예:
해당 유량에서 적절한 각도 제어 값은 49 입니다. 예측 Power: 2.739 kW범위 밖 응답 예:
해당 유량은 학습 데이터 범위 내 값이 아닙니다. 지원 범위: 500 ~ 900get_optimal_pump_control
입력:
{
"required_flow": 5.0
}MCP Resources
keti-flow://training-status
현재 서버 프로세스에 학습된 모델 상태, 데이터 파일, 행 수, 유량 범위를 반환합니다.
Codex 등록 예시
Codex MCP 설정에서 다음 형태로 등록합니다.
{
"mcpServers": {
"keti-flow": {
"command": "uv",
"args": [
"--directory",
"C:\\Users\\keti\\workspace\\KETI_FLOW_MCP",
"run",
"python",
"main.py"
]
}
}
}Claude 등록 예시
Claude Desktop 설정 파일의 mcpServers에 다음 항목을 추가합니다.
{
"mcpServers": {
"keti-flow": {
"command": "uv",
"args": [
"--directory",
"C:\\Users\\keti\\workspace\\KETI_FLOW_MCP",
"run",
"python",
"main.py"
]
}
}
}로컬 검증
tests/는 로컬 검증용 폴더이며 git에서 추적하지 않습니다.
간단한 smoke 검증:
uv run python -c "from src.mcp_server.server import build_runtime; r=build_runtime(); print(r.status())"송풍기 예측 확인:
uv run python -c "from src.mcp_server.server import build_runtime, optimal_control_text; r=build_runtime(); print(optimal_control_text(r, 'blower', 500))"git 추적 제외
다음 항목은 git에 포함하지 않습니다.
data/tests/.venv/모델 산출물 파일
로그와 로컬 출력물
Available Tools
2 toolsget_optimal_blower_angleB
이 도구는 송풍기의 날개 각도를 최적 제어하는 도구로서, 사용자가 송풍기의 유량을 입력하며 운전점을 알고 싶다고 하면 해당 도구를 호출하여 최적 운전점을 도출함.
Inputs: required_flow (required). Returns: result
get_optimal_pump_controlC
이 도구는 펌프의 VIGV를 최적 제어하는 도구로서, 사용자가 펌프의 유량을 입력하며 운전점을 알고 싶다고 하면 해당 도구를 호출하여 최적 운전점을 도출함.
Inputs: required_flow (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools address completely different physical devices (blower vs. pump), so there is no ambiguity in their purposes. Each has a clear and distinct function.
Both tools follow the same pattern of 'get_optimal_<device>_<control/angle>', using consistent verb_noun structure and snake_case. The minor difference in the last word (angle vs control) does not break consistency.
With only 2 tools, the server is very narrowly scoped. While this may be acceptable for a focused use case, it feels minimal for a general flow control system, suggesting the surface is thin.
The tools cover only optimization for two specific devices. There are no tools for monitoring current state, setting parameters, or managing other equipment, leaving significant operational gaps.
Maintenance
Related MCP Connectors
Heating, ventilation and energy engineering calculations and diagnostics for AI agents.
Cross-OEM industrial machine intelligence: identity, normalization, automation, attestation.
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Real-time electricity price signals for AI agents. Spot prices, cheapest hours, and contract recommendations. 31 countries across Europe and Oceania. No authentication required.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceExposes EnergyPlus building simulation tools as MCP endpoints, enabling LLMs to run closed-loop energy optimization while maintaining occupant comfort.-
- AlicenseNot gradedqualityDmaintenanceMCP server exposing distributed industrial asset data (battery storage, EV chargers, solar arrays) with tools for asset status, geospatial search, alerts, anomaly explanation, and load simulation.7,805 npmMIT
- AlicenseNot gradedqualityCmaintenanceExposes industrial motor telemetry data to AI agents via MCP and REST, enabling natural-language queries about motor status, health, and alerts. Provides a single tool and resource for retrieving real-time motor metrics and escalating critical conditions.MIT
- FlicenseNot gradedqualityBmaintenanceEnables LLM agents to access real-time wind turbine SCADA telemetry, verify ML-detected faults, and run agentic RAG diagnostics through MCP tool endpoints.-