关于 Coolprop
Coolprop 是面向工程师和研究人员的 MCP 服务,用于查询纯流体的热物性。它根据两个独立状态变量,通过 CoolProp 状态方程计算属性,而非查找表格值。
主要功能
- 01根据两个状态变量计算属性
- 02查询约 124 种标准流体名称
- 03每次调用返回至多 12 项属性
- 04列出支持的流体名称
- 05无法解析状态时返回错误
适用场景
- 01估算指定状态下水的密度和焓
- 02查询制冷剂的黏度和导热率
- 03查找流体的准确标准名称
MCP 相关
通过 MCP 工具提供流体属性计算和支持流体列表。可通过 stdio 在本地运行,也可连接 Pipeworx 网关;网关还提供共享元工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/coolprop/mcpclaude mcp add --transport http pipeworx-io-coolprop https://gateway.pipeworx.io/coolprop/mcp{"mcpServers":{"pipeworx-io-coolprop":{"type":"http","url":"https://gateway.pipeworx.io/coolprop/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-coolprop":{"type":"http","url":"https://gateway.pipeworx.io/coolprop/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-coolprop":{"type":"http","url":"https://gateway.pipeworx.io/coolprop/mcp"}}}{"mcpServers":{"pipeworx-io-coolprop":{"serverUrl":"https://gateway.pipeworx.io/coolprop/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
@pipeworx/coolprop
根据两个独立状态变量计算纯流体的热物性(PropsSI 风格:例如输入温度 + 压力,获取密度、焓、熵、黏度、热导率、比热、蒸气品质、相态)。覆盖约 124 种流体——水、常见制冷剂、烃类、低温流体、硅氧烷等——由 CoolProp 在进程内计算,而非查表,因此查询在每种流体的完整状态方程范围内都有效,不限于表格中列出的点。
属于 Pipeworx——一个将 AI Agent 连接到 1854 多个实时数据源的 MCP 网关。这是一个独立的非官方集成,与上游提供方无关联、未获其认可,也非其发布。
工具
coolprop_fluid_properties(fluid, input1_name, input1_value, input2_name, input2_value, outputs)— 输入两个独立状态变量(T、P、D、H、S、U或Q,采用 SI 单位),最多输出 12 个所需属性:T、P、D(密度,kg/m3)、H(焓,J/kg)、S(熵,J/kg/K)、U(内能,J/kg)、Q(蒸气品质)、CPMASS/CVMASS(比热,J/kg/K)、VISCOSITY(Pa·s)、CONDUCTIVITY(W/m/K)、PRANDTL、M(摩尔质量,kg/mol)、Phase(液态/气态/超临界/两相/...)。coolprop_list_fluids()— 列出此构建版本可识别的确切约 124 种流体规范名称。不支持别名:请使用 "CarbonDioxide",而非 "CO2"——此工具可用于查找准确拼写,无需猜测。
身份验证
无需密钥。
数据源
- CoolProp(Ian H. Bell 和 CoolProp 开发者)——一个开源热物性库(MIT 许可证)。每次调用都会根据 CoolProp 自身的状态方程在进程内计算属性;不会查询预构建的数值表,也不会从实时上游获取数据。
备注
- 不支持别名。 此构建版本的流体列表仅包含规范名称(例如 "CarbonDioxide"、"Nitrogen"、"R134a")——无法识别 "CO2" 等常见简称,并会返回明确错误,而非错误答案。调用
coolprop_list_fluids获取准确名称。 input1_name和input2_name必须是两个不同且相互独立的状态变量。 若重复询问T(或其他重复/依赖变量组合),会返回带名称的错误,而非无意义的数值。- CoolProp 无法解析的状态会返回带名称的错误,而非悄然返回错误数值。 对于无法解析的状态,CoolProp 底层采用的约定是 IEEE
Infinity哨兵值(而非抛出异常)——此工具包会检测该情况,并报告错误,注明流体、输入和有效输入代码,绝不会将Infinity当作真实的密度或焓返回。 - 少数(流体、状态)组合即使在物理上很平常的情况下也无法解析(在纯 CarbonDioxide 的一系列大气压温度下曾实时观察到这种情况)——由于在属性调用层面无法区分 CoolProp 求解器的真实缺陷和无效输入,因此会像超出范围的状态一样返回带名称的错误。如果预期可用的流体返回此错误,请先尝试其他输入组合(例如密度 + 温度,而不是压力 + 温度),再判定状态无效。
- 仅支持质量基准属性(此版本不支持摩尔基准输入/输出)。
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"coolprop": {
"url": "https://gateway.pipeworx.io/coolprop/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/coolprop/mcp 上的 tools/list 会返回上表中的工具,以及 Pipeworx 共享元工具——ask_pipeworx、
discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此,你看到的工具数量会多于此表:单个工具包端点目前会列出约 30 个共享工具,以及该工具包自身的工具。连接的 initialize 响应会说明确切的范围,并且是当天最权威的答案。
这是有意为之,并非意外地进行了多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点;如果额外的架构定义耗费的上下文超过了路由功能带来的价值,请连接一次完整网关,而不是连接多个工具包端点。
也可以连接完整的 Pipeworx 网关,直接列出每个工具包的所有工具,而不只是此工具包的工具:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
两个 URL 都会连接到同一个网关和相同的 1854+ 个数据源。唯一的区别是直接列出哪个工具包的工具;无论连接哪一个,ask_pipeworx 都能访问所有工具。
没有 MCP 客户端?通过 HTTP 调用
curl -X POST https://gateway.pipeworx.io/v1/tools/coolprop_fluid_properties \
-H 'Content-Type: application/json' \
-d '{"fluid":"Water","input1_name":"T","input1_value":298.15,"input2_name":"P","input2_value":101325,"outputs":["D","H","S","VISCOSITY","CONDUCTIVITY","Phase"]}'
首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/coolprop_fluid_properties。查找工具:使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。
独立运行(无需网关账户)
此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户,也无需经由网关往返:
{
"mcpServers": {
"coolprop": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-coolprop"]
}
}
}
或者直接运行,确认它能正常启动:
npx -y @pipeworx/mcp-coolprop
它通过 stdin/stdout 使用 MCP,并仅针对此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接添加的任何共享元工具。来源相同,工具相同,但不支持 ask_pipeworx 路由。
使用 ask_pipeworx
你可以用通俗易懂的语言提问,而不是直接调用工具——此功能既适用于上面的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Coolprop data" })
网关会自动选择合适的工具并填写参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。