MCP 工具參考

工具按治理切片與能力類別分組。每個工具標註呼叫所需的 scope。客戶環境中的實際可用工具以 MCP 執行時發現為準。

總覽

Slice	Endpoint	Required scope	Tools
基盤平台通用	/mcp/base/	base.action.write, base.compute.run, base.read	54
TrafficOps 車流與檢查點	/mcp/trafficops/	trafficops.read	7
預測性維護	/mcp/pdm/	pdm.read	5
TelcoOps 通訊網路運營	/mcp/telcoops/	telcoops.read	3
SemiOps 半導體與潔淨室	/mcp/semiops/	semiops.read	16
Aviation 航空可靠性	/mcp/aviation/	aviation.analysis.read, aviation.data.read	11

基盤平台通用

Endpoint: /mcp/base/

工具	Scope	說明
analyze_spare_parts	base.compute.run	分析備件庫存與使用模式。顯示更換最多的備件、滯銷庫存、缺貨風險和補貨建議。用於庫存最佳化與採購規劃。
analyze_spatial_anomaly	base.compute.run	分析空間熱力圖感測器資料中的異常。偵測數值偏離平均值超過 N 個標準差的感測器。適用於詢問冷熱點、異常讀數或空間離群點。
automl_forecast	base.compute.run	AutoML 模型自動選擇與預測——自動挑選最佳演算法。
calculate_emissions	base.compute.run	計算建築或設施的溫室氣體排放（範圍 1/2/3）。回傳依範圍劃分的 CO₂e 明細，並採用區域預設排放因子。適用於詢問碳足跡、排放或永續性指標。
cascade_simulation	base.compute.run	多引擎級聯模擬——串聯 DES、ABM、蒙地卡羅。
check_data_quality	base.read	查看所有已介接資料來源的資料品質儀表板。回傳依維度（完整性、準確性、一致性、時效性）的品質評分並列出主要違規項。適用於詢問資料品質、資料健康度或資料問題。
compare_zones	base.compute.run	比較兩個區域或樓層之間的空間統計。提供平均值、最小值、最大值、標準差比較及解讀。適用於比較南北、1 樓與 2 樓或任意兩個區域。
conformal_predict	base.compute.run	無分布假設的預測區間（保形預測）。
create_work_order	base.action.write	根據顧問的建議建立新的工單。僅在使用者明確同意採取行動時使用。
detect_anomaly	base.compute.run	對資料點進行異常評分（z-score、孤立森林、自編碼器）。
detect_drift	base.compute.run	偵測資料集之間的資料漂移或概念漂移。
estimate_causal_effect	base.compute.run	透過因果推論估計處理效應。
explain_prediction	base.compute.run	使用 SHAP 解釋模型預測。
extract_maintenance_record	base.read	使用 AI 從維修文件（PDF/圖片）中擷取結構化資料。回傳設備編號、維修日期、類型、技師、發現、更換的部件和信賴度評分。適用於將紙本維修紀錄數位化。
find_changepoints	base.compute.run	偵測時間序列中的結構性突變點。
find_optimal_policy	base.compute.run	使用因果推論尋找最佳處理策略。
find_path	base.compute.run	在建築內尋找兩點之間的導航路徑。支援跨樓層路由、無障礙選項和避開人群。
fit_distribution	base.compute.run	對觀測資料擬合機率分布。適用於分析故障時間、服務時長或到達模式。回傳最佳擬合分布及其參數和擬合優度統計（KS 檢定、AIC）。適用於了解哪種統計分布最能描述資料。
forecast_timeseries	base.compute.run	對時間序列執行 Holt-Winters 或 Prophet 預測。
generate_report	base.compute.run	產生狀態報告或模擬報告。適用於設備概覽、警示摘要或模擬分析報告。
get_action_plan_history	base.read	取得 AI 行動方案的歷史紀錄及其工作流程核准狀態。回傳過往行動方案的核准決定、執行結果，以及關聯的 ECM 文件（事件報告）。適用於回答有關過往事件、決策及其結果的問題。
get_compliance_documents	base.read	依標準篩選取得合規相關文件（證書、稽核報告、證據包）。適用於詢問 ISO 合規、FDA 或法規文件。
get_equipment_documents	base.read	取得與某設備關聯的所有文件（手冊、SOP、圖面、維修紀錄）。適用於詢問設備文件或尋找相關手冊/SOP。
get_equipment_status	base.read	取得設備即時狀態，包括最新感測器讀數、作用中警示和近期工單。適用於了解目前狀況。
get_expiring_documents	base.read	取得接近保存期限或需要定期複核的文件。用於合規監控和主動文件管理。
get_optimization_recommendation	base.compute.run	在預算限制下為檢查站營運尋找最佳人員配置。使用 NSGA-II 多目標最佳化在通行量與等待時間之間取得平衡。回傳帕雷托最佳解，附成本效益分析和可直接執行的操作。適用於回答「如何分配 10 名額外人員？」或「5000 元/小時預算下最佳配置是什麼？」等問題。
get_pending_tasks	base.read	取得待處理的 ECM 工作流程任務（待核准、待簽署或待複核的文件）。適用於詢問待辦清單或待核准事項。
import_data	base.compute.run	透過 ETL 管線從外部來源（REST API、CSV）匯入並處理資料以供分析。連接資料來源、擷取紀錄，並可選擇性地對匯入資料擬合分布。適用於將外部資料引入用於模擬輸入建模。
import_dxf	base.compute.run	匯入 DXF 平面圖並辨識牆體/門/窗/圍籬。
list_connectors	base.read	列出所有已設定的資料連接器（REST、CSV、MQTT、OPC-UA、資料庫等）及其目前狀態（作用中/錯誤/同步中）、上次同步時間和來源資訊。適用於詢問資料來源、整合、連接器或資料管線。
optimize_bayesian	base.compute.run	用於黑盒函數調校的貝氏最佳化。
optimize_evolutionary	base.compute.run	演化式多目標最佳化（NSGA-II）。
optimize_layout	base.compute.run	使用 NSGA-II 多目標最佳化並結合 DES 評估，最佳化設施的空間佈局（檢查站位置、容量、路線）。在通行量與等待時間間尋找帕雷托最佳佈局。適用於設施設計與空間規劃。
optimize_milp	base.compute.run	求解混合整數線性規劃（MILP）問題。
predict_rul	base.compute.run	根據感測器讀數預測剩餘使用壽命（RUL）。
predict_surrogate	base.compute.run	使用已訓練的代理模型進行推論。
query_knowledge	base.read	查詢知識圖譜中的設備類型、故障模式、維修動作、診斷規則和維護排程。適用於尋找專家知識。
recommend_model	base.compute.run	AutoML 推薦最佳模型類型。
recommend_sensor_placement	base.compute.run	依空間覆蓋盲區和 IDW 信賴度分析，推薦增設感測器的最佳位置。適用於詢問感測器部署、覆蓋盲區或在何處安裝新感測器。
recommend_training	base.read	根據設備類型、使用者角色和已辨識的技能落差推薦訓練課程。回傳帶時長和優先順序的課程清單。用於人才發展與認證規劃。
run_abm	base.compute.run	執行以智慧體為基礎的人群模擬。
run_dag_simulation	base.compute.run	執行帶進階路由（最短佇列、機率、條件）的 DAG 路由 DES 模擬。回傳通行量、瓶頸分析、Sankey 流量資料和 AI 建議。適用於複雜的多路徑檢查站情境。
run_des	base.compute.run	為流程/佇列建模執行離散事件模擬。
run_doe	base.compute.run	執行實驗設計（DOE）以辨識哪些因子對目標指標影響最顯著。回傳顯示因子顯著性的 ANOVA 分析。
run_montecarlo	base.compute.run	蒙地卡羅壓力測試/風險模擬。
run_optimization	base.compute.run	使用多目標最佳化（NSGA-II）尋找最佳參數。回傳在相互競爭目標間權衡的帕雷托最佳解。適用於尋找最佳配置。
run_simulation	base.compute.run	執行離散事件模擬（DES）以測試 what-if 情境。適用於驗證預測、比較配置或估算變更影響。可用場景：trafficops（檢查站車流）、heatops（區域供熱）、fms（設備生命週期）。
run_system_dynamics	base.compute.run	執行系統動力學（存量-流量）模擬。
run_what_if_comparison	base.compute.run	使用 DES 模擬將目前檢查站配置與修改後的情境進行比較。適用於回答「如果為生物辨識掃描增加 2 名人員會怎樣？」或「如果行李掃描器每 4 小時故障一次會怎樣？」等問題。回傳並排 KPI 比較、成本效益分析和具體的操作建議。支援人員調整、車道調整和設備故障注入。
search_checkpoint_sop	base.read	搜尋儲存在 ECM 系統中的檢查站標準作業程序（SOP）。回傳針對某檢查站或操作類型的相關 SOP 文件。適用於詢問檢查站管理、移民管控或海關通關的流程、規程或標準作業。借助 ECM RAG（檢索增強生成）進行語意搜尋。
search_documents	base.read	在 ECM（企業內容管理）中依關鍵字、類型或關聯實體搜尋文件。回傳文件標題、版本、密級和直達連結。啟用 RAG 增強後，還會提供相關文件的 AI 摘要。適用於詢問手冊、SOP、報告、證書或任何文件。
simulate_logistics	base.compute.run	在設施佈局上執行 AGV/堆高機物流模擬。
train_surrogate	base.compute.run	從資料訓練快速代理模型。
troubleshoot_connector	base.read	透過取得某資料連接器的詳情和近期同步紀錄來診斷它。分析近期錯誤並給出具體修復建議（憑證、網路、欄位對應等）。適用於連接器失敗、資料未同步或使用者回報匯入/匯出問題時。

analyze_spare_parts · base.compute.run

分析備件庫存與使用模式。顯示更換最多的備件、滯銷庫存、缺貨風險和補貨建議。用於庫存最佳化與採購規劃。

參數

Parameter	Type	Required	Description
equipment_type	string		依設備類型篩選（如 AHU、CHILLER）
part_category	string		依備件類別篩選
months	integer		要分析的歷史月數 - default: 12

analyze_spatial_anomaly · base.compute.run

分析空間熱力圖感測器資料中的異常。偵測數值偏離平均值超過 N 個標準差的感測器。適用於詢問冷熱點、異常讀數或空間離群點。

參數

Parameter	Type	Required	Description
scene_id	string	yes	場景 ID（heatops、iaq-building-env、energy-floor-consumption、space-occupancy）
variable	string	yes	要分析的變數（supply_temp、co2、electricity）
zone	string		區域篩選：all、north、south 等 - default: "all"
threshold_sigma	number		異常偵測的 sigma 門檻 - default: 2

automl_forecast · base.compute.run

AutoML 模型自動選擇與預測——自動挑選最佳演算法。

參數

Parameter	Type	Required	Description
values	array	yes
horizon	integer	yes	Forecast steps ahead.
frequency	string		Data frequency: min, h, d, w, m. - default: "h"
metric	string		Evaluation metric. - one of: mape, rmse, mae, smape - default: "mape"
candidates	array		Optional candidate model names.
ensemble	boolean		Create weighted ensemble of top models. - default: true
top_k	integer		Top model count for ensemble. - default: 3

calculate_emissions · base.compute.run

計算建築或設施的溫室氣體排放（範圍 1/2/3）。回傳依範圍劃分的 CO₂e 明細，並採用區域預設排放因子。適用於詢問碳足跡、排放或永續性指標。

參數

Parameter	Type	Required	Description
scope	integer	yes	排放範圍：1=直接，2=電力，3=價值鏈 - one of: 1, 2, 3
fuel_type	string		範圍 1 的燃料類型（如 natural_gas、diesel、refrigerant_r410a）
electricity_kwh	number		範圍 2 的用電量（kWh）
category	string		範圍 3 的類別（如 waste_landfill、water_supply、commuting_mrt）
consumption	number		相應單位下的消耗量
period	string		報告期（如 '2025-01'、'2025-Q1'、'2025'）

cascade_simulation · base.compute.run

多引擎級聯模擬——串聯 DES、ABM、蒙地卡羅。

參數

Parameter	Type	Required	Description
steps	array	yes
initial_payload	object
continue_on_error	boolean		Continue subsequent engines after a failed step. - default: false

check_data_quality · base.read

查看所有已介接資料來源的資料品質儀表板。回傳依維度（完整性、準確性、一致性、時效性）的品質評分並列出主要違規項。適用於詢問資料品質、資料健康度或資料問題。

參數

未宣告參數。請在執行時透過 tools/list 取得即時細節。

compare_zones · base.compute.run

比較兩個區域或樓層之間的空間統計。提供平均值、最小值、最大值、標準差比較及解讀。適用於比較南北、1 樓與 2 樓或任意兩個區域。

參數

Parameter	Type	Required	Description
scene_id	string	yes	場景 ID
variable	string	yes	要比較的變數
zone_a	string	yes	第一個區域（north、1f 等）
zone_b	string	yes	第二個區域（south、2f 等）

conformal_predict · base.compute.run

無分布假設的預測區間（保形預測）。

參數

Parameter	Type	Required	Description
train_data	array	yes
test_data	array	yes
target	string	yes	Target column name.
features	array	yes
confidence_levels	array		Confidence levels. - default: [0.9,0.95,0.99]
model_type	string		Base model type. - default: "random_forest"

create_work_order · base.action.write

根據顧問的建議建立新的工單。僅在使用者明確同意採取行動時使用。

參數

Parameter	Type	Required	Description
equipment_id	integer	yes	要為其建立工單的設備
title	string	yes	工單標題
description	string	yes	所需工作的詳細描述
priority	string	yes	one of: LOW, MEDIUM, HIGH, CRITICAL

detect_anomaly · base.compute.run

對資料點進行異常評分（z-score、孤立森林、自編碼器）。

參數

Parameter	Type	Required	Description
readings	array	yes	Sensor readings.
z_threshold	number		Z-score threshold. - default: 3

detect_drift · base.compute.run

偵測資料集之間的資料漂移或概念漂移。

參數

Parameter	Type	Required	Description
values	array	yes	Ordered time-series values.
method	string		Drift method. - one of: adwin, kswin, page_hinkley - default: "adwin"
delta	number		ADWIN delta. - default: 0.002
window_size	integer		KSWIN window size. - default: 100
stat_size	integer		KSWIN stat window size. - default: 30
threshold	number		PageHinkley threshold. - default: 50

estimate_causal_effect · base.compute.run

透過因果推論估計處理效應。

參數

Parameter	Type	Required	Description
data	array	yes
treatment	string	yes	Treatment column.
outcome	string	yes	Outcome column.
features	array
method	string		Estimator method.

explain_prediction · base.compute.run

使用 SHAP 解釋模型預測。

參數

Parameter	Type	Required	Description
model_type	string	yes	Model family or registered model type.
features	object	yes
prediction	number		Prediction value to explain.
background_data	array

extract_maintenance_record · base.read

使用 AI 從維修文件（PDF/圖片）中擷取結構化資料。回傳設備編號、維修日期、類型、技師、發現、更換的部件和信賴度評分。適用於將紙本維修紀錄數位化。

參數

Parameter	Type	Required	Description
document_id	integer	yes	要擷取的 ECM 文件 ID

find_changepoints · base.compute.run

偵測時間序列中的結構性突變點。

參數

Parameter	Type	Required	Description
values	array	yes	Time-series values.
method	string		Changepoint method. - one of: pelt, binary, window, bottomup - default: "pelt"
model	string		Cost model. - default: "rbf"
n_breakpoints	integer		Expected breakpoints for binary/window/bottomup.
min_size	integer		Minimum segment size. - default: 5
penalty	number		Penalty value for PELT.

find_optimal_policy · base.compute.run

使用因果推論尋找最佳處理策略。

參數

Parameter	Type	Required	Description
data	array	yes
treatment	string	yes	Treatment column.
outcome	string	yes	Outcome column.
features	array
policy_constraints	object

find_path · base.compute.run

在建築內尋找兩點之間的導航路徑。支援跨樓層路由、無障礙選項和避開人群。

參數

Parameter	Type	Required	Description
from_location	string	yes	起點位置名稱或節點 ID
to_location	string	yes	終點位置名稱或節點 ID
accessible	boolean		僅限無障礙（輪椅）路線 - default: false
avoid_crowds	boolean		避開壅擠區域 - default: false

fit_distribution · base.compute.run

對觀測資料擬合機率分布。適用於分析故障時間、服務時長或到達模式。回傳最佳擬合分布及其參數和擬合優度統計（KS 檢定、AIC）。適用於了解哪種統計分布最能描述資料。

參數

Parameter	Type	Required	Description
data_source	string	yes	擬合資料的來源。'custom' 需提供原始資料陣列。 - one of: sensor_readings, failure_times, service_times, custom
equipment_id	integer		感測器/故障資料的設備 ID（sensor_readings、failure_times 時必填）
sensor_type	string		sensor_readings 的感測器類型篩選（如 'temperature'、'vibration'）
custom_data	array		用於自訂擬合的原始資料點（至少 20 個）

forecast_timeseries · base.compute.run

對時間序列執行 Holt-Winters 或 Prophet 預測。

參數

Parameter	Type	Required	Description
model_name	string		Trained Prophet model name. - default: "default"
horizon	integer		Number of future periods to forecast. - default: 30
frequency	string		Forecast frequency: D, H, W. - default: "D"

generate_report · base.compute.run

產生狀態報告或模擬報告。適用於設備概覽、警示摘要或模擬分析報告。

參數

Parameter	Type	Required	Description
report_type	string	yes	報告類型：'simulation' 執行 DES 並報告 KPI，'equipment_status' 彙總目前設備/警示/工單 - one of: simulation, equipment_status
module	string		模擬報告所用模組 - one of: trafficops, heatops, fms
format	string		輸出格式 - one of: pdf, excel

get_action_plan_history · base.read

取得 AI 行動方案的歷史紀錄及其工作流程核准狀態。回傳過往行動方案的核准決定、執行結果，以及關聯的 ECM 文件（事件報告）。適用於回答有關過往事件、決策及其結果的問題。

參數

Parameter	Type	Required	Description
checkpoint_id	string		可選：依檢查站 ID 篩選
urgency	string		依緊急程度篩選。預設全部 - one of: CRITICAL, WARNING, ALL - default: "ALL"
limit	integer		回傳的最大結果數 - default: 10

get_compliance_documents · base.read

依標準篩選取得合規相關文件（證書、稽核報告、證據包）。適用於詢問 ISO 合規、FDA 或法規文件。

參數

Parameter	Type	Required	Description
standard	string		合規標準（如 ISO_14644、SEMI_S2、GM、FDA_21_CFR）
status	string		依文件狀態篩選 - one of: APPROVED, EXPIRED, IN_REVIEW, RECORD

get_equipment_documents · base.read

取得與某設備關聯的所有文件（手冊、SOP、圖面、維修紀錄）。適用於詢問設備文件或尋找相關手冊/SOP。

參數

Parameter	Type	Required	Description
equipment_id	integer	yes	設備 ID
doc_type	string		依文件類型篩選 - one of: MANUAL, SOP, DRAWING, REPORT, CERTIFICATE, PHOTO

get_equipment_status · base.read

取得設備即時狀態，包括最新感測器讀數、作用中警示和近期工單。適用於了解目前狀況。

參數

Parameter	Type	Required	Description
equipment_id	integer		要查詢的設備 ID（省略則為全部）

get_expiring_documents · base.read

取得接近保存期限或需要定期複核的文件。用於合規監控和主動文件管理。

參數

Parameter	Type	Required	Description
days_ahead	integer		向前檢查的天數 - default: 30

get_optimization_recommendation · base.compute.run

在預算限制下為檢查站營運尋找最佳人員配置。使用 NSGA-II 多目標最佳化在通行量與等待時間之間取得平衡。回傳帕雷托最佳解，附成本效益分析和可直接執行的操作。適用於回答「如何分配 10 名額外人員？」或「5000 元/小時預算下最佳配置是什麼？」等問題。

參數

Parameter	Type	Required	Description
budget	number		人員的每小時總預算（成本單位） - default: 5000
cost_per_staff	number		每名額外人員的每小時成本 - default: 100
target_kpi	string		要最佳化的主要 KPI - one of: avg_wait, throughput, p95_wait - default: "avg_wait"
audience	string		洞察報告的目標讀者 - one of: manager, operator, both - default: "both"

get_pending_tasks · base.read

取得待處理的 ECM 工作流程任務（待核准、待簽署或待複核的文件）。適用於詢問待辦清單或待核准事項。

參數

Parameter	Type	Required	Description
user_id	integer		使用者 ID（省略則為目前使用者）

import_data · base.compute.run

透過 ETL 管線從外部來源（REST API、CSV）匯入並處理資料以供分析。連接資料來源、擷取紀錄，並可選擇性地對匯入資料擬合分布。適用於將外部資料引入用於模擬輸入建模。

參數

Parameter	Type	Required	Description
connector_type	string	yes	資料連接器類型：'rest' 表示 REST API，'csv' 表示 CSV 檔 - one of: rest, csv
endpoint	string	yes	REST API 的 URL 或 CSV 的檔案路徑
pipeline_id	string		可選 ETL 管線：'arrival-fitting' 或 'service-time' - one of: arrival-fitting, service-time
field_mapping	object		可選的來源→目標欄位對應（如 {'timestamp': 'arrival_time'}）

import_dxf · base.compute.run

匯入 DXF 平面圖並辨識牆體/門/窗/圍籬。

參數

Parameter	Type	Required	Description
file_path	string		Server-side DXF path.
content	string		DXF content when file_path is not used.
layers	array
recognize	boolean		Recognize walls/doors/windows/fences. - default: true

list_connectors · base.read

列出所有已設定的資料連接器（REST、CSV、MQTT、OPC-UA、資料庫等）及其目前狀態（作用中/錯誤/同步中）、上次同步時間和來源資訊。適用於詢問資料來源、整合、連接器或資料管線。

參數

未宣告參數。請在執行時透過 tools/list 取得即時細節。

optimize_bayesian · base.compute.run

用於黑盒函數調校的貝氏最佳化。

參數

Parameter	Type	Required	Description
parameters	array	yes
objective_name	string		Objective label. - default: "objective"
direction	string		Optimization direction. - one of: minimize, maximize - default: "minimize"
n_trials	integer		Trial count. - default: 50
evaluations	array
sampler	string		Sampler. - one of: tpe, cmaes, random - default: "tpe"

optimize_evolutionary · base.compute.run

演化式多目標最佳化（NSGA-II）。

參數

Parameter	Type	Required	Description
variables	array	yes
objectives	array	yes
constraints	array
population_size	integer		Population size. - default: 100
generations	integer		Generation count. - default: 50
seed	integer		Optional random seed.

optimize_layout · base.compute.run

使用 NSGA-II 多目標最佳化並結合 DES 評估，最佳化設施的空間佈局（檢查站位置、容量、路線）。在通行量與等待時間間尋找帕雷托最佳佈局。適用於設施設計與空間規劃。

參數

Parameter	Type	Required	Description
template_id	string	yes	要最佳化的佈局範本 - one of: immigration-hall-small, security-screening, departure-lounge
objectives	array		要最佳化的目標
pop_size	integer		NSGA-II 族群規模
n_gen	integer		演化代數

optimize_milp · base.compute.run

求解混合整數線性規劃（MILP）問題。

參數

Parameter	Type	Required	Description
variables	array	yes
objective	object	yes
constraints	array

predict_rul · base.compute.run

根據感測器讀數預測剩餘使用壽命（RUL）。

參數

Parameter	Type	Required	Description
equipment_id	string	yes	Equipment identifier.
health_data	array	yes	Recent health indicator values.
failure_history	array		Optional historical failure times.

predict_surrogate · base.compute.run

使用已訓練的代理模型進行推論。

參數

Parameter	Type	Required	Description
model_name	string	yes	Model name.
inputs	array	yes

query_knowledge · base.read

查詢知識圖譜中的設備類型、故障模式、維修動作、診斷規則和維護排程。適用於尋找專家知識。

參數

Parameter	Type	Required	Description
query_type	string	yes	要查詢的知識類型 - one of: equipment_info, failure_modes, repair_actions, diagnostic_rules
equipment_type	string		設備類型（如 COMPRESSOR、AHU、PUMP、CHILLER）
keyword	string		自由文字知識搜尋的關鍵字

recommend_model · base.compute.run

AutoML 推薦最佳模型類型。

參數

Parameter	Type	Required	Description
values	array	yes	Series values.
task	string		Task type. - one of: forecast, anomaly - default: "forecast"

recommend_sensor_placement · base.compute.run

依空間覆蓋盲區和 IDW 信賴度分析，推薦增設感測器的最佳位置。適用於詢問感測器部署、覆蓋盲區或在何處安裝新感測器。

參數

Parameter	Type	Required	Description
scene_id	string	yes	場景 ID
variable	string	yes	用於覆蓋分析的變數
zone	string		要分析的區域。使用 all 表示整個區域。 - default: "all"
max_recommendations	integer		佈點建議的最大數量 - default: 5

recommend_training · base.read

根據設備類型、使用者角色和已辨識的技能落差推薦訓練課程。回傳帶時長和優先順序的課程清單。用於人才發展與認證規劃。

參數

Parameter	Type	Required	Description
equipment_type	string		設備類型（如 AHU、CHILLER、COMPRESSOR）
user_role	string		用於角色客製訓練的使用者角色 - one of: operator, technician, engineer, manager - default: "operator"
skill_gap	string		需彌補的已辨識技能落差

run_abm · base.compute.run

執行以智慧體為基礎的人群模擬。

參數

Parameter	Type	Required	Description
width	integer	yes	Grid width.
height	integer	yes	Grid height.
num_agents	integer	yes	Agent count.
exits	array	yes
obstacles	array
steps	integer		Simulation steps. - default: 100

run_dag_simulation · base.compute.run

執行帶進階路由（最短佇列、機率、條件）的 DAG 路由 DES 模擬。回傳通行量、瓶頸分析、Sankey 流量資料和 AI 建議。適用於複雜的多路徑檢查站情境。

參數

Parameter	Type	Required	Description
scene_id	string	yes	要模擬的 DAG 場景 - one of: cp-immigration-dag, cp-security-dag, cp-multi-terminal
simulation_time	number		模擬時長（分鐘）
staff_count	integer		人員/車道數量（影響容量）

run_des · base.compute.run

為流程/佇列建模執行離散事件模擬。

參數

Parameter	Type	Required	Description
sceneType	string	yes	Registered DES scene type.
sceneId	string	yes	Scene configuration id.
simulationTime	number		Simulation time in minutes. - default: 480
seed	integer		Optional random seed.
replications	integer		Replication count. - default: 1
moduleConfig	object
playback	boolean		Emit replay events. - default: false
parallel	boolean		Run replications in parallel.
maxWorkers	integer		Max parallel workers. - default: 4
shiftSchedule	array
failureConfig	object

run_doe · base.compute.run

執行實驗設計（DOE）以辨識哪些因子對目標指標影響最顯著。回傳顯示因子顯著性的 ANOVA 分析。

參數

Parameter	Type	Required	Description
scene_type	string	yes	one of: trafficops, heatops, fms
scene_id	string	yes
factors	array	yes	實驗中要變動的因子
response_metric	string	yes	要分析的 KPI（如 throughput、availability、total_heat_delivered_kj）

run_montecarlo · base.compute.run

蒙地卡羅壓力測試/風險模擬。

參數

Parameter	Type	Required	Description
model_name	string	yes	Human-readable model name.
parameters	object	yes	Parameter name -> distribution spec {distribution,args}.
output_expression	string	yes	Safe Python expression referencing sampled parameters.
n_simulations	integer		Number of iterations. - default: 10000
confidence_level	number		Confidence level. - default: 0.95

run_optimization · base.compute.run

使用多目標最佳化（NSGA-II）尋找最佳參數。回傳在相互競爭目標間權衡的帕雷托最佳解。適用於尋找最佳配置。

參數

Parameter	Type	Required	Description
module_type	string	yes	one of: trafficops, heatops, fms
population_size	integer		default: 20
generations	integer		default: 10

run_simulation · base.compute.run

執行離散事件模擬（DES）以測試 what-if 情境。適用於驗證預測、比較配置或估算變更影響。可用場景：trafficops（檢查站車流）、heatops（區域供熱）、fms（設備生命週期）。

參數

Parameter	Type	Required	Description
scene_type	string	yes	要執行的模擬類型 - one of: trafficops, heatops, fms
scene_id	string	yes	場景設定 ID（如 'rts-main-hall'、'small-network'、'hvac-fleet'）
simulation_time	number		模擬時間（分鐘） - default: 480
config_overrides	object		覆寫場景參數（如 num_counters、supply_temp）

run_system_dynamics · base.compute.run

執行系統動力學（存量-流量）模擬。

參數

Parameter	Type	Required	Description
stocks	object	yes	Stock name -> initial value.
flows	array
auxiliaries	array
parameters	object		Model parameters.
dt	number		Integration timestep. - default: 0.25
duration	number	yes	Total simulation time.

run_what_if_comparison · base.compute.run

使用 DES 模擬將目前檢查站配置與修改後的情境進行比較。適用於回答「如果為生物辨識掃描增加 2 名人員會怎樣？」或「如果行李掃描器每 4 小時故障一次會怎樣？」等問題。回傳並排 KPI 比較、成本效益分析和具體的操作建議。支援人員調整、車道調整和設備故障注入。

參數

Parameter	Type	Required	Description
changes	object		各檢查站的覆寫項：{checkpoint_id: {staff_count, mean_service_time, counters}}。範例：{'biometric-scan': {'staff_count': 4}, 'bag-scan': {'staff_count': 3}}
failure_injection	object		各檢查站的故障設定：{checkpoint_id: {mtbf, mttr}}。範例：{'biometric-scan': {'mtbf': 240, 'mttr': 15}} —— 掃描器每 4 小時故障一次，修復 15 分鐘
label	string		修改情境的可讀標籤 - default: "Modified Scenario"
audience	string		洞察報告的目標讀者 - one of: manager, operator, both - default: "both"
replications	integer		模擬重複次數（越多越準確，但越慢） - default: 5

search_checkpoint_sop · base.read

搜尋儲存在 ECM 系統中的檢查站標準作業程序（SOP）。回傳針對某檢查站或操作類型的相關 SOP 文件。適用於詢問檢查站管理、移民管控或海關通關的流程、規程或標準作業。借助 ECM RAG（檢索增強生成）進行語意搜尋。

參數

Parameter	Type	Required	Description
query	string	yes	SOP 內容的搜尋查詢（如 '尖峰時段開道流程'、'生物辨識掃描器降級預案'、'VIP 旅客處理'）
checkpoint_id	string		可選：限定搜尋範圍的特定檢查站 ID
doc_type	string		要搜尋的文件類型。預設全部 - one of: SOP, INCIDENT_REPORT, CAPACITY_PLANNING, ALL - default: "ALL"

search_documents · base.read

在 ECM（企業內容管理）中依關鍵字、類型或關聯實體搜尋文件。回傳文件標題、版本、密級和直達連結。啟用 RAG 增強後，還會提供相關文件的 AI 摘要。適用於詢問手冊、SOP、報告、證書或任何文件。

參數

Parameter	Type	Required	Description
query	string		搜尋關鍵字（標題、描述、內容）
doc_type	string		依文件類型篩選 - one of: MANUAL, SOP, REPORT, DRAWING, CERTIFICATE, PHOTO, CONTRACT, TEMPLATE
entity_type	string		依關聯實體類型篩選 - one of: EQUIPMENT, ALERT, WORK_ORDER, CLEANROOM, SMT_LINE
entity_id	integer		用於篩選的實體 ID
use_rag	boolean		啟用以 RAG 為基礎的 AI 摘要 - default: true

simulate_logistics · base.compute.run

在設施佈局上執行 AGV/堆高機物流模擬。

參數

Parameter	Type	Required	Description
layout	object	yes
agvs	array
tasks	array
simulationTime	number		Simulation time. - default: 480
seed	integer		Optional random seed.

train_surrogate · base.compute.run

從資料訓練快速代理模型。

參數

Parameter	Type	Required	Description
model_name	string	yes	Model name.
inputs	array	yes
outputs	array	yes
model_type	string		Surrogate model type. - default: "random_forest"
test_size	number		Validation split. - default: 0.2

troubleshoot_connector · base.read

透過取得某資料連接器的詳情和近期同步紀錄來診斷它。分析近期錯誤並給出具體修復建議（憑證、網路、欄位對應等）。適用於連接器失敗、資料未同步或使用者回報匯入/匯出問題時。

參數

Parameter	Type	Required	Description
connector_name	string	yes	要診斷的連接器名稱或部分名稱

TrafficOps 車流與檢查點

Endpoint: /mcp/trafficops/

工具	Scope	說明
check_officer_roster	trafficops.read	查看檢查站目前班次的人員排班與人力可用情況。回傳所有已部署人員及其崗位、可調配的備勤人員，以及下次換班時間。適用於詢問排班、人力或能否增派人手。
evaluate_lane_reconfig	trafficops.read	執行 DES（離散事件模擬），將目前車道配置與擬議的重新配置（例如關閉一條汽車道以新增一條機車道）進行比較。使用真實模擬引擎計算等待時間、通行量和 SLA 達成率。可提供使用者回報的到達率、排隊長度等資料以提升模擬準確性。適用於在決策前量化車道調整的取捨。
get_checkpoint_lane_status	trafficops.read	取得車輛檢查站的即時車道狀態，包括各車道使用率、排隊長度、等待時間和值勤人員。涵蓋機車道和汽車道。可提供使用者回報資料（排隊長度、到達率、車道數）以覆寫預設值。適用於詢問目前檢查站狀況、壅塞或車道容量。
get_proactive_alerts	trafficops.read	依預測與 SLA 比較，取得主動式壅塞警示。回傳預測的 SLA 違約項，附嚴重度、證據和改善建議（預算型/速度型/平衡型）。適用於詢問潛在的即將發生的問題或壅塞風險。
get_surge_detection	trafficops.read	取得某檢查站目前的交通激增/異常偵測狀態。依車型（機車、汽車、巴士）偵測到達率的異常飆升。回傳激增幅度、估計持續時間、可能原因和初步建議。可提供使用者回報的到達率以覆寫預設值。適用於詢問目前交通異常或意外壅塞。
get_traffic_forecast	trafficops.read	取得某檢查站未來 8 小時的車流預測。回傳每 15 分鐘的預測通行量（人/小時）及信賴帶。適用於檢查是否預計壅塞並提前規劃。
get_traffic_patterns	trafficops.read	使用 DOE 統計分析取得某交通檢查站的重複性模式。回傳星期效應、時段尖峰和瓶頸模式，附 p 值和信賴水準。適用於了解結構性的交通行為。

check_officer_roster · trafficops.read

查看檢查站目前班次的人員排班與人力可用情況。回傳所有已部署人員及其崗位、可調配的備勤人員，以及下次換班時間。適用於詢問排班、人力或能否增派人手。

參數

Parameter	Type	Required	Description
shift	string		要查看的班次：'current'、'morning'、'afternoon'、'night' - default: "current"

evaluate_lane_reconfig · trafficops.read

執行 DES（離散事件模擬），將目前車道配置與擬議的重新配置（例如關閉一條汽車道以新增一條機車道）進行比較。使用真實模擬引擎計算等待時間、通行量和 SLA 達成率。可提供使用者回報的到達率、排隊長度等資料以提升模擬準確性。適用於在決策前量化車道調整的取捨。

參數

Parameter	Type	Required	Description
close_lanes	array	yes	要關閉的車道 ID（如 ['CAR-4']）
open_lanes	array	yes	要新開的車道配置（如 [{'id': 'MC-6', 'type': 'motorcycle', 'from_lane': 'CAR-4'}]）
motorcycle_arrival_rate_hr	number		機車到達率（輛/小時）
car_arrival_rate_hr	number		汽車到達率（輛/小時）
motorcycle_lanes	integer		基線中目前機車道數量
car_lanes	integer		基線中目前汽車道數量
motorcycle_queue_length	integer		目前機車排隊長度（等待車輛總數）
car_queue_length	integer		目前汽車排隊長度（等待車輛總數）
simulation_time_min	number		模擬時長（分鐘）

get_checkpoint_lane_status · trafficops.read

取得車輛檢查站的即時車道狀態，包括各車道使用率、排隊長度、等待時間和值勤人員。涵蓋機車道和汽車道。可提供使用者回報資料（排隊長度、到達率、車道數）以覆寫預設值。適用於詢問目前檢查站狀況、壅塞或車道容量。

參數

Parameter	Type	Required	Description
scene_id	string		場景 ID（如 border-lbc-arrival-car、border-lbc-departure-car） - default: "border-lbc-arrival-car"
motorcycle_lanes	integer		覆寫機車道數量
car_lanes	integer		覆寫汽車道數量
motorcycle_queue_total	integer		使用者回報的全部車道機車排隊總長
car_queue_total	integer		使用者回報的全部車道汽車排隊總長
motorcycle_arrival_rate_hr	number		使用者回報的機車到達率（輛/小時）
car_arrival_rate_hr	number		使用者回報的汽車到達率（輛/小時）

get_proactive_alerts · trafficops.read

依預測與 SLA 比較，取得主動式壅塞警示。回傳預測的 SLA 違約項，附嚴重度、證據和改善建議（預算型/速度型/平衡型）。適用於詢問潛在的即將發生的問題或壅塞風險。

參數

Parameter	Type	Required	Description
sla_minutes	number		等待時間的 SLA 門檻（分鐘） - default: 12

get_surge_detection · trafficops.read

取得某檢查站目前的交通激增/異常偵測狀態。依車型（機車、汽車、巴士）偵測到達率的異常飆升。回傳激增幅度、估計持續時間、可能原因和初步建議。可提供使用者回報的到達率以覆寫預設值。適用於詢問目前交通異常或意外壅塞。

參數

Parameter	Type	Required	Description
checkpoint	string		檢查站區域（如 vehicle-arrival、pedestrian-arrival） - default: "vehicle-arrival"
motorcycle_arrival_rate_hr	number		使用者回報的機車到達率（輛/小時）
car_arrival_rate_hr	number		使用者回報的汽車到達率（輛/小時）
motorcycle_lanes	integer		機車道數量（用於受影響車道清單）

get_traffic_forecast · trafficops.read

取得某檢查站未來 8 小時的車流預測。回傳每 15 分鐘的預測通行量（人/小時）及信賴帶。適用於檢查是否預計壅塞並提前規劃。

參數

Parameter	Type	Required	Description
checkpoint	string		檢查站 ID（如 document-check、biometric-scan、security-screen） - default: "document-check"
hours	integer		向前預測的小時數（1–24） - default: 8

get_traffic_patterns · trafficops.read

使用 DOE 統計分析取得某交通檢查站的重複性模式。回傳星期效應、時段尖峰和瓶頸模式，附 p 值和信賴水準。適用於了解結構性的交通行為。

參數

Parameter	Type	Required	Description
checkpoint	string		檢查站 ID - default: "document-check"
days	integer		要分析的歷史資料天數 - default: 90

預測性維護

Endpoint: /mcp/pdm/

工具	Scope	說明
get_equipment_health	pdm.read	取得某台預測性維護設備的健康狀態。回傳健康評分（0–100）、等級（A/B/C/D/F）、異常級別、峰值因子和振動 RMS。
get_filter_circular_recovery	pdm.read	取得目前租戶或單台設備的預測性維護濾芯部件的即時循環回收與售後展望。回傳回收候選項、風險等級、剩餘壽命、建議措施及售後或處置指引。適用於濾芯部件的循環回收、再利用、再製造、處置、售後或永續性問題。
get_filter_component_intelligence	pdm.read	取得目前租戶或單台設備的即時預測性維護濾芯部件情報。回傳目前需關注的部件，包括風險等級、預測剩餘壽命、建議措施、基準對照和售後說明。適用於詢問濾芯部件、部件情報、客戶設備群濾芯、目前最需關注的事項或部件級維護優先順序。
get_pdm_summary	pdm.read	取得預測性維護設備群健康摘要：設備數量、等級分布（A/B/C/D/F）、關鍵設備數、作用中警示、7 天健康趨勢。
list_pdm_anomalies	pdm.read	列出預測性維護異常：軸承磨損、過熱、振動超標。回傳類型、嚴重度、設備和 AI 建議。

get_equipment_health · pdm.read

取得某台預測性維護設備的健康狀態。回傳健康評分（0–100）、等級（A/B/C/D/F）、異常級別、峰值因子和振動 RMS。

參數

Parameter	Type	Required	Description
equipment_name	string	yes	設備名稱或編碼（如 VB-VP-001、真空泵）
equipment_id	string		設備 UUID（可選）

get_filter_circular_recovery · pdm.read

取得目前租戶或單台設備的預測性維護濾芯部件的即時循環回收與售後展望。回傳回收候選項、風險等級、剩餘壽命、建議措施及售後或處置指引。適用於濾芯部件的循環回收、再利用、再製造、處置、售後或永續性問題。

參數

Parameter	Type	Required	Description
equipment_id	string		設備 ID（可選）
equipment_code	string		設備編碼或名稱，如 MH-MP-001（可選）
top_n	integer		要突顯的部件數量

get_filter_component_intelligence · pdm.read

取得目前租戶或單台設備的即時預測性維護濾芯部件情報。回傳目前需關注的部件，包括風險等級、預測剩餘壽命、建議措施、基準對照和售後說明。適用於詢問濾芯部件、部件情報、客戶設備群濾芯、目前最需關注的事項或部件級維護優先順序。

參數

Parameter	Type	Required	Description
equipment_id	string		設備 ID（可選）
equipment_code	string		設備編碼或名稱，如 MH-EX-003（可選）
top_n	integer		要突顯的部件數量

get_pdm_summary · pdm.read

取得預測性維護設備群健康摘要：設備數量、等級分布（A/B/C/D/F）、關鍵設備數、作用中警示、7 天健康趨勢。

參數

Parameter	Type	Required	Description
tenant_filter	string

list_pdm_anomalies · pdm.read

列出預測性維護異常：軸承磨損、過熱、振動超標。回傳類型、嚴重度、設備和 AI 建議。

參數

Parameter	Type	Required	Description
severity	string		one of: ALL, CRITICAL, HIGH, MEDIUM, LOW
status	string		one of: OPEN, RESOLVED, ALL
limit	integer

TelcoOps 通訊網路運營

Endpoint: /mcp/telcoops/

工具	Scope	說明
analyze_network_health	telcoops.read	透過取得概覽、鏈路使用率和未關閉事件來分析電信網路健康度。回傳分級敘述（A–F），含節點/鏈路數量、事件摘要、最高風險鏈路、財務影響估算和優先順序建議。適用於詢問網路狀態、NOC 概覽、電信健康度或基礎設施風險。
explain_incident	telcoops.read	用自然語言解釋某個具體的電信網路事件。回傳嚴重度、偵測時間、根因、客戶/營收影響，以及分步補救措施（即時、短期、長期）。適用於詢問某個特定事件、警示或故障。
predict_capacity	telcoops.read	依目前使用率和成長趨勢預測鏈路容量超限。辨識使用率超過 70% 的鏈路，估算距超限門檻的天數，並回傳若延遲擴容的 CapEx 需求和 SLA 罰款曝險。適用於詢問容量規劃、頻寬預測或擴容優先順序。

analyze_network_health · telcoops.read

透過取得概覽、鏈路使用率和未關閉事件來分析電信網路健康度。回傳分級敘述（A–F），含節點/鏈路數量、事件摘要、最高風險鏈路、財務影響估算和優先順序建議。適用於詢問網路狀態、NOC 概覽、電信健康度或基礎設施風險。

參數

未宣告參數。請在執行時透過 tools/list 取得即時細節。

explain_incident · telcoops.read

用自然語言解釋某個具體的電信網路事件。回傳嚴重度、偵測時間、根因、客戶/營收影響，以及分步補救措施（即時、短期、長期）。適用於詢問某個特定事件、警示或故障。

參數

Parameter	Type	Required	Description
incident_id	string	yes	要解釋的事件 ID

predict_capacity · telcoops.read

依目前使用率和成長趨勢預測鏈路容量超限。辨識使用率超過 70% 的鏈路，估算距超限門檻的天數，並回傳若延遲擴容的 CapEx 需求和 SLA 罰款曝險。適用於詢問容量規劃、頻寬預測或擴容優先順序。

參數

未宣告參數。請在執行時透過 tools/list 取得即時細節。

SemiOps 半導體與潔淨室

Endpoint: /mcp/semiops/

工具	Scope	說明
analyze_env_correlation	semiops.read	分析潔淨室內環境參數（溫度、濕度、壓力、顆粒）之間的相關性，協助辨識哪些參數相互影響。尤其適用於診斷溫濕度對錫膏性能、PCB 層壓品質和光刻曝光精度的影響。
classify_smt_defects	semiops.read	對 SMT 缺陷進行分類，提供帕雷托分析和根因建議。顯示依類型/嚴重度的缺陷分布、DPMO 及可執行的改善措施。可辨識 PCB/FPC 特有缺陷，包括錫膏問題、立碑、連錫、缺件、虛焊和焊墊脫落。
forecast_fab_load	semiops.read	使用以模式為基礎的模型預測未來 24–168 小時的晶圓廠用電負載。辨識尖峰/離峰時段和需量反應機會。
get_cleanroom_status	semiops.read	取得潔淨室即時狀態，包括溫度、濕度、壓力、顆粒計數和 ISO 合規情況。涵蓋層壓間、PCB/FPC 曝光區及通用半導體潔淨室。適用於詢問潔淨室環境或污染水準。省略 cleanroom_id 可取得所有潔淨室。
get_fab_pue	semiops.read	取得晶圓廠目前的能源使用效率（PUE）及能耗明細（IT 負載、製冷、照明、暖通等）和基準評級。適用於 PCB/FPC 工廠、半導體晶圓廠和電子製造廠。適用於能效相關問題。
get_filter_life	semiops.read	依壓差趨勢預測 HEPA/ULPA 濾芯的剩餘壽命。顯示距需更換濾芯的估計剩餘天數。涵蓋 PCB 曝光區、層壓區和半導體晶圓廠的潔淨室濾芯。請勿用於預測性維護/行動設備的濾芯部件（如挖掘機、裝載機、發電機或客戶設備群資產）。
get_iso_compliance	semiops.read	取得潔淨室的 ISO 14644 合規狀態與評估歷史。顯示目前等級、合格/不合格狀態及歷史評估趨勢。
get_particle_trend	semiops.read	取得某潔淨室隨時間變化的顆粒計數趨勢。顯示顆粒水準的變化，協助辨識污染事件或劣化模式。
get_pressure_gradient	semiops.read	取得潔淨室成對之間的壓力梯度級聯狀態。顯示房間間壓差是否正確維持，以防止交叉污染。
get_smt_oee	semiops.read	取得 SMT（表面黏著技術）產線的 OEE（設備綜合效率），含可用率 × 效能 × 品質的拆解。涵蓋 PCB 組裝線，包括錫膏印刷、貼片、回流焊和 AOI 工位。適用於生產效率相關問題。
get_utility_status	semiops.read	取得公用工程系統狀態，包括 CDA（潔淨乾燥空氣）、N2（氮氣）、PCW（製程冷卻水）和 UPW（超純水）。顯示壓力、流量、純度讀數。
monitor_particles	semiops.read	對照 ISO 14644-1 限值即時監控潔淨室的顆粒計數。回傳各粒徑的評估、超限警示和整體狀態。
optimize_chiller_cop	semiops.read	在多台機組間最佳化冰水主機負載分配以最大化系統 COP。比較最佳策略與均勻負載策略並計算節能量。
predict_env_trend	semiops.read	預測潔淨室未來 2–4 小時的環境參數趨勢（溫度、濕度、顆粒）。用於主動監控和早期預警。
run_soft_sensors	semiops.read	執行虛擬軟測量，從可用的潔淨室感測器資料估算無法直接測量的參數（AMC 分子污染 ppb、露點 °C、HEPA 濾芯負載 %）。適用於在無直接測量時詢問分子污染、AMC 水準、露點或濾芯狀態。
simulate_smt_bottleneck	semiops.read	對 SMT 產線執行離散事件模擬，辨識通行量瓶頸工位、使用率失衡和最佳化機會。

analyze_env_correlation · semiops.read

分析潔淨室內環境參數（溫度、濕度、壓力、顆粒）之間的相關性，協助辨識哪些參數相互影響。尤其適用於診斷溫濕度對錫膏性能、PCB 層壓品質和光刻曝光精度的影響。

參數

Parameter	Type	Required	Description
cleanroom_id	string	yes	要分析的潔淨室 ID

classify_smt_defects · semiops.read

對 SMT 缺陷進行分類，提供帕雷托分析和根因建議。顯示依類型/嚴重度的缺陷分布、DPMO 及可執行的改善措施。可辨識 PCB/FPC 特有缺陷，包括錫膏問題、立碑、連錫、缺件、虛焊和焊墊脫落。

參數

Parameter	Type	Required	Description
line_id	string		SMT 產線 ID（可選，省略則為全部產線）
days	integer		要分析的缺陷資料天數 - default: 7

forecast_fab_load · semiops.read

使用以模式為基礎的模型預測未來 24–168 小時的晶圓廠用電負載。辨識尖峰/離峰時段和需量反應機會。

參數

Parameter	Type	Required	Description
hours_ahead	integer		預測時長（1–168 小時） - default: 24

get_cleanroom_status · semiops.read

取得潔淨室即時狀態，包括溫度、濕度、壓力、顆粒計數和 ISO 合規情況。涵蓋層壓間、PCB/FPC 曝光區及通用半導體潔淨室。適用於詢問潔淨室環境或污染水準。省略 cleanroom_id 可取得所有潔淨室。

參數

Parameter	Type	Required	Description
cleanroom_id	string		潔淨室 ID（省略則為全部）

get_fab_pue · semiops.read

取得晶圓廠目前的能源使用效率（PUE）及能耗明細（IT 負載、製冷、照明、暖通等）和基準評級。適用於 PCB/FPC 工廠、半導體晶圓廠和電子製造廠。適用於能效相關問題。

參數

未宣告參數。請在執行時透過 tools/list 取得即時細節。

get_filter_life · semiops.read

依壓差趨勢預測 HEPA/ULPA 濾芯的剩餘壽命。顯示距需更換濾芯的估計剩餘天數。涵蓋 PCB 曝光區、層壓區和半導體晶圓廠的潔淨室濾芯。請勿用於預測性維護/行動設備的濾芯部件（如挖掘機、裝載機、發電機或客戶設備群資產）。

參數

Parameter	Type	Required	Description
cleanroom_id	string		潔淨室 ID（省略則為全部濾芯）

get_iso_compliance · semiops.read

取得潔淨室的 ISO 14644 合規狀態與評估歷史。顯示目前等級、合格/不合格狀態及歷史評估趨勢。

參數

Parameter	Type	Required	Description
cleanroom_id	string		潔淨室 ID（省略則為全部）

get_particle_trend · semiops.read

取得某潔淨室隨時間變化的顆粒計數趨勢。顯示顆粒水準的變化，協助辨識污染事件或劣化模式。

參數

Parameter	Type	Required	Description
cleanroom_id	string	yes	要查詢的潔淨室 ID
hours	integer		要取得的歷史小時數 - default: 24
particle_size	string		粒徑篩選（如 '0.5um'、'5.0um'）

get_pressure_gradient · semiops.read

取得潔淨室成對之間的壓力梯度級聯狀態。顯示房間間壓差是否正確維持，以防止交叉污染。

參數

未宣告參數。請在執行時透過 tools/list 取得即時細節。

get_smt_oee · semiops.read

取得 SMT（表面黏著技術）產線的 OEE（設備綜合效率），含可用率 × 效能 × 品質的拆解。涵蓋 PCB 組裝線，包括錫膏印刷、貼片、回流焊和 AOI 工位。適用於生產效率相關問題。

參數

Parameter	Type	Required	Description
line_id	string		SMT 產線 ID（省略則為全部產線）

get_utility_status · semiops.read

取得公用工程系統狀態，包括 CDA（潔淨乾燥空氣）、N2（氮氣）、PCW（製程冷卻水）和 UPW（超純水）。顯示壓力、流量、純度讀數。

參數

未宣告參數。請在執行時透過 tools/list 取得即時細節。

monitor_particles · semiops.read

對照 ISO 14644-1 限值即時監控潔淨室的顆粒計數。回傳各粒徑的評估、超限警示和整體狀態。

參數

Parameter	Type	Required	Description
cleanroom_id	string	yes	要監控的潔淨室 ID

optimize_chiller_cop · semiops.read

在多台機組間最佳化冰水主機負載分配以最大化系統 COP。比較最佳策略與均勻負載策略並計算節能量。

參數

Parameter	Type	Required	Description
cooling_demand_kw	number	yes	總製冷需求（kW）
ambient_temp_c	number		室外環境溫度 °C - default: 35

predict_env_trend · semiops.read

預測潔淨室未來 2–4 小時的環境參數趨勢（溫度、濕度、顆粒）。用於主動監控和早期預警。

參數

Parameter	Type	Required	Description
cleanroom_id	string	yes	要預測的潔淨室 ID
parameter	string		要預測的環境參數 - one of: temperature, humidity, particles, pressure
hours	integer		向前預測的小時數（1–8） - default: 4

run_soft_sensors · semiops.read

執行虛擬軟測量，從可用的潔淨室感測器資料估算無法直接測量的參數（AMC 分子污染 ppb、露點 °C、HEPA 濾芯負載 %）。適用於在無直接測量時詢問分子污染、AMC 水準、露點或濾芯狀態。

參數

Parameter	Type	Required	Description
temperature_c	number		目前潔淨室溫度（°C）
humidity_pct	number		目前相對濕度 %
particle_05um	number		目前 0.5 µm 顆粒計數（顆/m³）
air_changes_hour	integer		每小時換氣次數（ACH） - default: 600
cleanroom_age_days	integer		潔淨室使用天數（影響釋氣 AMC 估算） - default: 365
filter_dp_pa	number		目前 HEPA/ULPA 濾芯壓差（Pa） - default: 200
filter_initial_dp_pa	number		全新潔淨濾芯的壓差（Pa） - default: 50
filter_max_dp_pa	number		濾芯更換門檻壓差（Pa） - default: 450
filter_operating_hours	number		濾芯累計運轉小時數 - default: 4380

simulate_smt_bottleneck · semiops.read

對 SMT 產線執行離散事件模擬，辨識通行量瓶頸工位、使用率失衡和最佳化機會。

參數

Parameter	Type	Required	Description
line_id	string		SMT 產線 ID（可選，使用預設設定）
sim_hours	number		模擬時長（小時） - default: 8
boards	integer		要生產的板數 - default: 500

Aviation 航空可靠性

Endpoint: /mcp/aviation/

工具	Scope	說明
aviation_component_compare	aviation.analysis.read	比較不同部件組之間的可靠性表現。
aviation_fault_query	aviation.data.read	原始故障记录明细查询(按机型/机号/基地/ATA/关键字/来源/时间过滤,分页)
aviation_fleet_stats	aviation.analysis.read	依 ATA 章節和故障分布彙總機隊可靠性訊號。
aviation_fleet_utilization_query	aviation.data.read	机队利用率明细(飞行小时/起落/在册数),分页
aviation_kpi_attribution	aviation.analysis.read	將某項可靠性 KPI 歸因到支撐它的故障紀錄與證據。
aviation_kpi_monthly_query	aviation.data.read	官方月度 KPI 明细(aviation_kpi_monthly,只读),分页
aviation_removal_query	aviation.data.read	原始拆换记录明细(aviation_fact_removal),分页
aviation_repetitive_fault_detect	aviation.analysis.read	偵測並彙總重複性故障組，供可靠性審查使用。
aviation_risk_register_query	aviation.data.read	风险登记册明细(aviation_risk_register),分页
aviation_text_mining_scan	aviation.analysis.read	掃描維修文字，辨識重複出現或異常的技術問題候選項。
aviation_weibull_fit	aviation.analysis.read	對選定的更換或拆換資料擬合 Weibull 可靠性曲線。

aviation_component_compare · aviation.analysis.read

比較不同部件組之間的可靠性表現。

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
cohort	string		Comparison cohort. - one of: ORIGINAL_VS_REPAIR - default: "ORIGINAL_VS_REPAIR"
method	string		Weibull fitting method for both cohorts. - one of: MLE, LSM - default: "MLE"
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_fault_query · aviation.data.read

原始故障记录明细查询(按机型/机号/基地/ATA/关键字/来源/时间过滤,分页)

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
unit	string		Alias for base.
aircraftReg	string		Aircraft registration.
aircraftNo	string		Alias for aircraftReg.
ataChapter	string		ATA chapter filter.
ataSection	string		ATA section filter.
keyword	string		LIKE filter over fault description and message code.
source	string		Fault source, for example FTS or APCM.
dateFrom	string		Inclusive occurrence date start, yyyy-MM-dd.
dateTo	string		Exclusive occurrence date end, yyyy-MM-dd.
page	integer		Zero-based page number. - default: 0
pageSize	integer		Rows per page; server clamps to 1..500. - default: 50
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_fleet_stats · aviation.analysis.read

依 ATA 章節和故障分布彙總機隊可靠性訊號。

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_fleet_utilization_query · aviation.data.read

机队利用率明细(飞行小时/起落/在册数),分页

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
page	integer		Zero-based page number. - default: 0
pageSize	integer		Rows per page; server clamps to 1..500. - default: 50
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_kpi_attribution · aviation.analysis.read

將某項可靠性 KPI 歸因到支撐它的故障紀錄與證據。

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
kpiCode	string	yes	KPI code to attribute, for example mech_sdr_rate.
yearMonths	array	yes	Months to inspect, formatted YYYY-MM.
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_kpi_monthly_query · aviation.data.read

官方月度 KPI 明细(aviation_kpi_monthly,只读),分页

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
page	integer		Zero-based page number. - default: 0
pageSize	integer		Rows per page; server clamps to 1..500. - default: 50
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_removal_query · aviation.data.read

原始拆换记录明细(aviation_fact_removal),分页

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
page	integer		Zero-based page number. - default: 0
pageSize	integer		Rows per page; server clamps to 1..500. - default: 50
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_repetitive_fault_detect · aviation.analysis.read

偵測並彙總重複性故障組，供可靠性審查使用。

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
state	string		Repetitive-fault queue state. - default: "PENDING"
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_risk_register_query · aviation.data.read

风险登记册明细(aviation_risk_register),分页

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
page	integer		Zero-based page number. - default: 0
pageSize	integer		Rows per page; server clamps to 1..500. - default: 50
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_text_mining_scan · aviation.analysis.read

掃描維修文字，辨識重複出現或異常的技術問題候選項。

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

aviation_weibull_fit · aviation.analysis.read

對選定的更換或拆換資料擬合 Weibull 可靠性曲線。

參數

Parameter	Type	Required	Description
base	string		Maintenance base/unit filter.
aircraftType	string		Single aircraft type filter, for example A320 or B737NG.
aircraftTypes	array		Aircraft type group; use only when the tool supports merged scopes.
ataChapters	array		ATA chapter filters, for example ['27', '32'].
partNumber	string		Component part number filter for reliability/component tools.
fromDate	string		Inclusive ISO date start for the data scope, yyyy-MM-dd.
toDate	string		Inclusive ISO date end for the data scope, yyyy-MM-dd.
criticalOnly	boolean		Limit to critical issues where the aviation module supports it.
method	string		Weibull fitting method. - one of: MLE, LSM - default: "MLE"
rightCensoringEnabled	boolean		Include right-censored observations. - default: true
dataScope	object		Compatibility envelope accepted by older clients. Prefer direct fields.
params	object		Compatibility envelope accepted by older clients. Prefer direct fields.

JSON 參考: tools.json