v0.2.2

Linux 修复版本。

修复

• Linux CLI 后端：之前会用到 baltamaticaC.sh 包装脚本，而该脚本会吞掉命令行参数，导致 -s "<代码>" 无法传到解释器（返回启动横幅、什么都没执行）。改用 baltamatica.sh（透传参数并自动设置库路径）。
• 无显示器 Linux：在没有 DISPLAY 的 Linux（SSH/服务器/CI）上自动设置 QT_QPA_PLATFORM=offscreen，让 -nodesktop 解释器能正常启动。

已在 macOS 和无头 Linux 上端到端实测通过（sum([1 2;3 4])=10、list/set 均正常）。

pip install -U baltamatica-mcp

预编译 BEX 桥接二进制随本 Release 附带（与 v0.2.0/v0.2.1 相同，BEX 源码未变）。

v0.2.1

安装体验简化版本。

变化

• CLI 后端零配置：自动探测北太天元标准安装位置（macOS /Applications/Baltamatica.app/...、Linux /opt/Baltamatica/bin/baltamatica.sh、Windows C:\Program Files\Baltamatica\...），标准安装下 baltamatica-mcp --backend cli 直接可用，无需再指定路径。
• 一键安装桥接：新增 baltamatica-mcp install-bridge，自动下载对应平台的 mcp_bridge.bex* 到 ~/.baltamatica-mcp/ 并打印启动命令。

pip install -U baltamatica-mcp

预编译 BEX 桥接二进制（macOS/Linux/Windows）随本 Release 附带，与 v0.2.0 相同（BEX 源码未变）。基于 BEX SDK v3.9 / 北太天元 2025。

v0.2.0

让 AI 代理（Claude Code / Cursor / Codex）通过 MCP 驱动北太天元（Baltamatica）做交互式科学计算。

安装

pip install baltamatica-mcp

本版本亮点（BEX 后端）

• 变量读取：数值/逻辑数组二进制全保真回传（实数和复数、任意大小）；字符/字符串/结构体/元胞结构化序列化。
• 变量注入 set_variable：整数（int8..uint64）/浮点（float32/64）/复数（complex64/128）/bool，缓冲读取大 payload（约 16 MB）。
• 输出捕获：execute_code / run_script 用 evalc 捕获控制台输出、失败返回错误信息，并解析 BALTAMATICA_ARTIFACT= 文件产物。
• 生命周期健壮化：可靠 stop、Ctrl-C 恢复、自愈重绑、background 模式、状态返回值。
• CLI 后端：无需编译、跨平台，开箱即用。

预编译 BEX 桥接二进制

下载对应平台的 mcp_bridge.bex*，放到某目录，在北太天元里 addpath('...'); mcp_bridge('background')，再让 Python 端 --backend bex 连接。

• macOS (arm64)：mcp_bridge.bexmaci64
• Linux (x86-64)：mcp_bridge.bexa64
• Windows：暂未提供，可用 scripts/build_bex.sh 自行编译

基于 BEX SDK v3.9 / 北太天元 2025。图形导出到文件受限于北太天元本身缺少相关函数，暂不支持（详见 README）。