fact sim MCP

fact_sim MCP服务器（独立仓库）

fact_sim_mcp 是一个独立的MCP服务器，用于控制 fact_sim 来自单独存储库的web应用程序。

工具

1. load_example(example: string)
2. start_simulation()
3. stop_simulation()
4. run_benchmark(wallMs?: number)
5. export_timeline_csv()
6. build_share_url()
7. get_simulation_status()
8. get_kpi_summary()
9. run_scenario_matrix(examples: string[], wallMs?: number)
10. list_examples()
11. set_simulation_mode(mode: "dt" | "event")
12. set_playback_speed(speed?: number, fastest?: boolean)
13. reset_simulation_clock()
14. capture_snapshot_png(fileName?: string)
15. export_graph_json(pretty?: boolean)
16. import_graph_json(graphJson: string)
17. set_simulation_time(simTimeMs: number)
18. get_graph_overview(includeNodes?: boolean, maxNodes?: number)
19. export_embedded_html(fileName?: string)
20. save_timeline_csv(fileName?: string)
21. save_graph_json(fileName?: string, pretty?: boolean)
22. load_graph_json_file(filePath: string)
23. run_matrix_and_save_report(examples: string[], wallMs?: number, fileName?: string)
24. validate_graph_json(graphJson: string)
25. save_kpi_summary_json(fileName?: string, pretty?: boolean)
26. save_graph_overview_json(fileName?: string, includeNodes?: boolean, maxNodes?: number, pretty?: boolean)
27. evaluate_candidate_graph(graphJson: string, wallMs?: number, objective?: "throughput" | "throughput_per_node" | "balanced")
28. rank_candidate_graphs(candidates: string[], wallMs?: number, objective?: "throughput" | "throughput_per_node" | "balanced", topK?: number)
29. suggest_topology_improvements(graphJson: string, maxSuggestions?: number)
30. list_node_types()
31. add_node(nodeType: string, title?: string, x?: number, y?: number, properties?: Record)
32. get_node_ports(nodeId: string | number)
33. get_node_ports_by_kind(nodeId: string | number, portKind: "work" | "signal" | "carrier" | "pallet")
34. connect_nodes_by_port_kind(fromNodeId: string | number, toNodeId: string | number, portKind: "work" | "signal" | "carrier" | "pallet", fromSlot?: number, toSlot?: number, allowDuplicate?: boolean)
35. connect_work_ports(fromNodeId: string | number, toNodeId: string | number, fromSlot?: number, toSlot?: number, allowDuplicate?: boolean)
36. connect_signal_ports(fromNodeId: string | number, toNodeId: string | number, fromSlot?: number, toSlot?: number, allowDuplicate?: boolean)
37. connect_carrier_ports(fromNodeId: string | number, toNodeId: string | number, fromSlot?: number, toSlot?: number, allowDuplicate?: boolean)
38. connect_pallet_ports(fromNodeId: string | number, toNodeId: string | number, fromSlot?: number, toSlot?: number, allowDuplicate?: boolean)
39. update_node(nodeId: string | number, title?: string, properties?: Record, mergeProperties?: boolean)
40. connect_nodes(fromNodeId: string | number, toNodeId: string | number, fromSlot?: number, toSlot?: number, allowDuplicate?: boolean)
41. disconnect_nodes(linkId?: number, fromNodeId?: string | number, toNodeId?: string | number, fromSlot?: number, toSlot?: number, removeAllMatches?: boolean)
42. remove_node(nodeId: string | number)
43. clear_graph()
44. repair_graph_links()
45. run_simulation_for(wallMs: number, mode?: "dt" | "event", fastest?: boolean, includeBenchmark?: boolean, benchmarkWallMs?: number)
46. get_bottleneck_report(topN?: number, minSampleSec?: number)
47. describe_node_type(nodeType: string)
48. build_graph_from_blueprint(nodes: BlueprintNodeInput[], edges?: BlueprintEdgeInput[], clearExisting?: boolean, originX?: number, originY?: number, xPitch?: number, yPitch?: number)
49. optimize_line_by_bottleneck(iterations?: number, runWallMs?: number, bottleneckTopN?: number, minSampleSec?: number, maxNodesPerIteration?: number, processReductionRatio?: number, downReductionRatio?: number, minProcessTime?: number, minDownTime?: number)
50. set_takt_target_and_objective(taktSec: number, objectiveWeights?: { throughput?: number; taktGap?: number; cycleTime?: number; nodeCount?: number; linkCount?: number; completion?: number })
51. validate_layout_rules(minDistance?: number, forbiddenAdjacency?: string[])
52. run_design_of_experiments(paramGrid: DoeParamGridInput, wallMs?: number)
53. set_random_seed(seed: number)
54. get_random_seed()

特性

• Node.js+TypeScript
• 本地stdio传输（用于VSCode/Cox）
• 异常处理（工具级、启动级、流程级）
• 带有请求ID的Stderr日志记录(req:)
• 最小依赖性(@modelcontextprotocol/sdk, playwright, zod)

目录布局

fact_sim_mcp/
  src/
    index.ts
    fact-sim-runtime.ts
  dist/                     # generated by npm run build
  .vscode/
    mcp.json                # VSCode local server definition
  package.json
  tsconfig.json
  mcp.config.example.json   # generic MCP client example
  README.md

需求

• Node.js 18+
• fact_sim 存储库 index.html 可用的
• 铬为剧作家

安装和构建

npm install
npx playwright install chromium
npm run build

跑

npm start

服务器目标 fact_sim 根按以下顺序排列：

1. FACT_SIM_ROOT 环境变量
2. 兄弟路径 ../fact_sim 相对于此存储库

如果两者都不解析为包含以下内容的目录 index.html，启动失败，出现显式错误。

VSCode/Cox配置

地方 fact_sim 和 fact_sim_mcp 在同一父目录下。则不需要环境变量。

.vscode/mcp.json （推荐）

{
  "servers": {
    "fact-sim-mcp": {
      "command": "node",
      "args": ["dist/index.js"]
    }
  }
}

通用的 mcp.config.example.json

{
  "mcpServers": {
    "fact-sim-mcp": {
      "command": "node",
      "args": ["G:/マイドライブ/プログラミング/github/fact_sim_mcp/dist/index.js"]
    }
  }
}

如果存储库不是兄弟库，请设置 FACT_SIM_ROOT 在MCP客户端配置中明确显示。

故障排除

• Playwright启动错误：运行 npx playwright install chromium
• fact_sim root not found：set FACT_SIM_ROOT 到包含以下内容的文件夹 index.html
• 端口 8123 使用中：服务器自动回退到打开的本地端口