仅供内部测试 - 即将准备就绪

Modelica MCP 服务器

一个模型上下文协议服务器，提供 Modelica 模型仿真能力。该服务器使 LLM 能够检索和处理 Modelica 相关的任务。

什么是 MCP，请参考 https://modelcontextprotocol.io/

可用工具

• modelica_simulate - 通过源代码运行 Modelica 模型仿真。

  • modelica_code (字符串，必需): Modelica 模型的源代码

• modelica_service_available - 检查 Modelica 服务可用性（稍后将用于启动后端环境）。

  • 无输入

提示词 - 暂不支持

• 仿真提示词
  • 仿真结果
  • 参数:
    • modelica code (字符串，必需): ...

安装

获取 "ORTHOGONAL_TOKEN"

• 您需要在 paas.orthogonal.cc 上注册

1. 登录到 Orthogonal：打开浏览器，登录到 https://paas.orthogonal.cc
2. 获取令牌：成功登录后，按 F12 进入开发者模式，然后单击“Network”，最后按 F5 刷新，网络通信将在此处显示，找到“status/”记录并显示其标头，令牌类似于 eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzQ1MjI3NjAzLCJpYXQiOjE3NDQ2MjI4MDMsImp0aSI6IjY4MmFmOTA0MjA5ZDRmYWZiNTI1MmIyYTg1MjMxZDQ3IiwidXNlcl9pZCI6OH0.NKbo6NNtSzyzNebXSlmbRLYkf_5ffdWALT7OxXDr6b8 (不包含 'Bearer ')
3. 记录此令牌，它将用于填写 MCP 配置

Cursor 安装：使用 uv (推荐)

当使用 uv 时，无需进行特定安装。我们将使用 uvx 直接运行 modelica_simulate。

uv 安装 <br> curl -LsSf https://astral.sh/uv/install.sh | sh

1. 克隆 mcp 服务器<br> git clone https://github.com/Orthogonalpub/modelica_simulation_mcp_server

2. 进入目录<br> cd modelica_simulation_mcp_server

3. 创建虚拟环境<br> uv venv

4. 激活虚拟环境<br> Windows: <br> .venv\Scripts\activate<br>

Mac / Linux: <br> source .venv\Scripts\activate<br>

5. 添加依赖项<br> uv add "mcp[cli]" httpx websocket-client pandas --active

配置

为 cursor/Claude.app 配置

添加到您的 cursor/Claude 设置：mcp.json (位于您的用户主目录或 .cursor/ 目录中) 在 cursor 中，您可以通过单击“Settings” -> “MCP” -> “Add new global MCP server”来打开此文件

<details> <summary>使用 uvx</summary>

示例：

1. 正确设置 "ORTHOGONAL_TOKEN"
2. 根据您的本地安装正确设置 "args" 和 "command" 的路径

<br>Windows mcp.json 示例 <br>

{
  "mcpServers": {
      "modelica-mcp-server": {
          "connectionType": "stdio", 
          "command": "C:\\arbeit\\99.fmi\\modelica_simulation_mcp_server\\.venv\\Scripts\\python.exe",
          "args": [
              "C:\\arbeit\\99.fmi\\modelica_simulation_mcp_server\\main.py"
            ],
            "env": {
              "ORTHOGONAL_TOKEN": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzQ0NzE3MDk1LCJpYXQiOjE3NDQxMTIyOTUsImp0aSI6IjMyYTczOTljMDJjZDQxZDBiNWYwNzVmZDBiNjk3YmI4IiwidXNlcl9pZCI6OH0.49PfrGwxpP0yehrb6_bd0TZh4v_uo2pj5jvy10xH18U",
              "DEBUG": "true",
              "LOG_LEVEL": "verbose",
              "PORT": "9223"
              },
            "disabled": false,
            "autoApprove": []
      }
  }
}

<br>Mac mcp.json 示例 <br>

{
        "mcpServers": {
                "modelica-mcp-server": {
                        "connectionType": "stdio",
                        "command": "/opt/homebrew/bin/uv",
                        "args": [
            			    "--directory",
           			     "/Users/rainnie/Downloads/halo/modelica_simulation_mcp_server/",
           			     "run",
                                     "/Users/rainnie/Downloads/halo/modelica_simulation_mcp_server/main.py"
                        ],
                        "env": {
                                "ORTHOGONAL_TOKEN": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzQ0OTY2OTQxLCJpYXQiOjE3NDQzNjIxNDEsImp0aSI6ImE5M2RlNDUyMGU1ZDQ3M2RiZjVjOTFhMDgxZDEyYThjIiwidXNlcl9pZCI6NDR9.k0RM8as9PtFX1cvCowOQeZraDPM-Qks4dl9uFauHUH8",
                                "DEBUG": "true",
                                "LOG_LEVEL": "verbose",
                                "PORT": "9223"
                        },
                        "disabled": false,
                        "autoApprove": []
                }
        }
}

</details>

成功安装后，mcp 服务器将显示，并且状态图标为绿色

自定义 - 仿真参数 - 暂不支持

将来，可以配置服务器以使用不同的仿真参数 --stop-time 和 --step-size ...

调试

使用 mcp inspector mcp dev main.py 需要在 mcp inspector 窗口中添加环境变量

许可证

modelica-simulation 在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。