Text2Sim MCP 服务器

用于 LLM 集成的多范式仿真引擎

Text2Sim MCP 服务器 是一个支持多种建模范式的仿真引擎，包括离散事件仿真 (DES) 和系统动力学 (SD)。它使用 模型上下文协议 (MCP) 与 LLM 集成，从而在 Claude Desktop 等自然语言环境中实现强大的仿真功能。

---

🚀 特性

• 大型语言模型 (LLM) 集成 使用 LLM 的纯英文描述创建仿真模型。

• 多范式支持

  • 离散事件仿真 (DES)：使用 SimPy 进行面向过程的模型
  • 系统动力学 (SD)：使用 PySD 进行反馈驱动的连续模型

• 多领域支持 构建用于机场运营、医疗保健、制造业、供应链等领域的仿真。

• 灵活的模型配置

  • DES: 可配置的实体，具有随机过程逻辑
  • SD: 具有反馈回路和基于时间的方程的库存流量模型

• 实时指标

  • DES: 性能指标，如等待时间和吞吐量
  • SD: 库存、流量和辅助变量的时间序列数据

• 安全实现 使用基于正则表达式的解析（而非 eval()）来处理分布输入和安全模型执行。

---

🔧 安装

先决条件

• Python 3.12 或更高版本
• uv 包管理器

安装 uv

在 macOS 和 Linux 上：

curl -LsSf https://astral.sh/uv/install.sh | sh

在 Windows 上 (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

了解更多：astral-sh/uv

---

🛠️ 用法

克隆存储库

git clone https://github.com/IamCatoBot/text2sim-MCP-server.git

与 Claude Desktop 集成

1. 打开：

Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json

2. 添加以下代码块：

{
  "mcpServers": {
    "Text2Sim MCP Server": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_TEXT2SIM_MCP_SERVER", 
        "run",
        "mcp_server.py"
      ],
      "env": {}
    }
  }
}

注意： 如果找不到 uv 命令，请运行 which uv (Unix) 或 Get-Command uv (PowerShell) 并在 "command" 字段中使用完整路径。

---

📚 API 参考

概述

MCP 服务器提供用于离散事件仿真和系统动力学建模的工具：

• 离散事件仿真：使用 SimPy 进行面向过程的建模
• 系统动力学：使用 PySD 进行库存流量建模

当使用大型语言模型（例如 Claude）客户端时，自然语言提示会通过 模型上下文协议 (MCP) 转换为适当的配置。

---

🏗️ 架构

Text2Sim 被构建为模块化组件：

• MCP 服务器 – 通过 MCP 处理自然语言请求。
• 离散事件仿真 (DES) 模块
  • 仿真模型 – 执行过程流的核心 SimPy 引擎。
  • 实体类 – 表示流经系统的单元。
  • 过程步骤 – 封装每个过程阶段的逻辑。
  • 指标收集器 – 收集等待时间和吞吐量等统计信息。
  • 安全分布解析器 – 安全地解析概率分布。
• 系统动力学 (SD) 模块
  • 模型注册表 – 管理可用的 SD 模型。
  • PySD 集成 – 使用 PySD 运行库存流量模型。
  • 仿真控制 – 时间步长、持续时间和参数调整。
  • 结果格式化器 – 构造用于输出的时间序列数据。

有关每个模块的详细文档，请参见：

• DES 模块文档
• SD 模块文档

---

🔐 安全注意事项

• 不使用 eval() 基于正则表达式的解析可防止任意代码执行。

• 输入验证 在执行之前，会验证分布类型、参数和模型配置。

• 强大的错误处理 错误会清晰地报告，而不会泄漏内部状态。

---

🤝 贡献

欢迎提交 Pull Request！请 fork 该存储库并提交 PR。 欢迎提出建议、错误报告和功能想法。

---

📄 许可证

本项目根据 MIT 许可证 获得许可。 有关详细信息，请参见 LICENSE 文件。