# rofilter [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/szhuangzan/rofilter-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1949  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/rofilter

## Description
MCP integration for ROFilter, a reverse-osmosis membrane system design software (rofilter.cn): membrane library, water analysis & full system design. stdio MCP (Coze/Doubao, Qwen, WorkBuddy, Claude, Cursor), Streamable HTTP, DeepSeek Harness bundle, plus

## Tools
Capabilities this server exposes over MCP:

- **list_elements** — 查询膜元件库（共 742 件，覆盖 DuPont/Toray/Veolia/Vontron/Ovay/Hydranautics/LG/CSM）。可按品牌、系列、关键词、适用 TDS 筛选；默认返回前 30 条，支持 offset+limit 分页或用 all=true 一次取全量。选型时先用它挑出候选元件。
- **get_element** — 按元件名称取完整参数（尺寸、性能、测试条件、极限值）。设计计算前若要核对某个元件的适用边界（最高温度、pH 范围、最大压差），用它。
- **analyze_water** — 进水水质分析：由离子组成算出 TDS、渗透压、电导率、LSI/CCPP 等结垢指数、碳酸平衡（CO2/CO3/HCO3）与碱度。判断这股水能否直接进 RO、需不需要软化或加酸。
- **run_design** — 跑一次完整的反渗透系统设计计算（与 rofilter.cn 网页端同引擎）。给定进水水质、回收率、产水量和膜排列，返回进水压力、产水 TDS、浓水浓度、能耗、通量、逐段结果。这是本服务最核心的工具。判读：平均通量低于 12 lmh 说明膜面积偏大（投资浪费），高于 20 lmh 偏小（污染快），vessels 应按目标通量反算。
- **analyze_scaling** — 结垢评估与最大可持续回收率：按进水水质求加/不加阻垢剂两档的结垢限定最大回收率及限制矿物（LSI、CaSO4、BaSO4、SrSO4、CaF2、SiO2、磷酸钙），在设计回收率处逐项判定浓水饱和度并推荐阻垢剂投加量，再扫描进水 pH 2~11 给出最佳 pH 与加酸/加碱量。与 rofilter.cn 分析页同源。适合在 run_design 之前确定回收率上限、要不要加酸。
- **list_schemes** — 列出「通用方案」里的行业配置模板（电力、制药、电子、食品饮料、海水淡化等），含关键设计参数，可作为起点参考。
- **compare_designs** — 多方案对比：给定进水水质与设计参数，对每个候选元件/排列各跑一次完整设计，返回进水压力、产水 TDS、平均通量、单位能耗的横向对比表。适合选型时对比 2~5 个候选元件；候选的 vessels 缺省时按目标通量（默认 15 lmh）自动反算。
- **run_tender_case** — 端到端招标/演示：给定进水水质与设计目标，自动完成「水质分析 → 结垢评估定回收率 → 元件选型 → 设计计算 → 结论」全流程，一步输出可直接引用的方案结论。适合招标演示、方案初筛、快速给客户一个可核对的结果。

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "rofilter": {
    "command": "npx",
    "args": ["-y","rofilter"]
  }
}
```

## Documentation

## What rofilter does

rofilter exposes ROFilter’s reverse-osmosis design functions through MCP. The remote service at rofilter.cn provides a membrane library containing 742 elements from eight brands, water-quality calculations, scaling analysis, system design, and industry-specific scheme templates. AI clients can use these functions to compare membrane elements, interpret feed-water data, assess operating constraints, or calculate a proposed system.

The available operations are:

- `list_elements` searches the membrane catalog by brand, family, keyword, or TDS range. Results support pagination, with an option to return the full catalog.
- `get_element` returns the full specifications and operating limits for one membrane.
- `analyze_water` calculates TDS, conductivity, osmotic pressure, LSI, Ryznar, CCPP, carbonate balance, and salt saturation values.
- `analyze_scaling` evaluates scaling risk, sustainable maximum recovery, limiting minerals, antiscalant scenarios, recovery-rate checks, antiscalant recommendations, and pH scans.
- `run_design` calculates a complete multi-stage system, including feed pressure, product-water TDS, energy use, stage flux, and pressure drop.
- `list_schemes` lists templates for power, pharmaceutical, electronics, food and beverage, and seawater desalination applications.

Lookup and assessment operations are free. `run_design` is metered and includes a daily free allowance.

## How it works

The package offers two connection modes. In stdio mode, the `rofilter-mcp` executable starts a local bridge that forwards MCP initialization, tool discovery, and tool calls to ROFilter’s Streamable HTTP endpoint. The bridge maintains the MCP session identifier and handles JSON and SSE responses. It uses Node’s built-in `fetch`, so the package has no runtime dependencies.

Remote clients can instead connect directly to `https://rofilter.cn/mcp` using Streamable HTTP. HTTP requests authenticate with a Bearer token, while the local bridge reads the token from its environment. Both modes use the calculation service hosted by rofilter.cn, and the results are intended to match the ROFilter web application.

## Setup and configuration

For local MCP clients, configure a server with `npx -y rofilter`; the equivalent binary name is `rofilter-mcp`. Node.js 18 or newer is required. A token is optional for the shared trial access, but a personal token can be generated from the ROFilter account settings under MCP access.

Example stdio configuration:

```json
{
  "mcpServers": {
    "rofilter": {
      "command": "npx",
      "args": ["-y", "rofilter"],
      "env": { "ROFILTER_TOKEN": "rfmcp_your_token" }
    }
  }
}
```

For direct HTTP access, use `https://rofilter.cn/mcp` and send `Authorization: Bearer rfmcp_your_token`. The repository also contains Agent Skill packages in standard nested and flat layouts. These provide workflow guidance and reference material, but the MCP connection still needs to be configured in the client.

## Tools and capabilities

The membrane catalog can be narrowed by manufacturer, product family, search term, or TDS suitability, then read in pages or retrieved in full. Water analysis covers both common feed-water indicators and less basic chemistry, including carbonate equilibrium and mineral saturation. Scaling analysis compares operation with and without antiscalant and can scan pH to identify a preferred value and acid or alkali dosing.

System design covers multiple stages and reports hydraulic and quality outputs together, including inlet pressure, permeate TDS, energy consumption, per-stage flux, and pressure loss. Scheme templates provide starting points for several industrial sectors. These capabilities make the server suitable for conversational design checks, preliminary sizing questions, and structured comparisons of membrane choices.

## Limitations and notes

`run_design` is the metered operation, while query and assessment tools are free within the service’s access rules. The package includes shared trial access with a daily allowance; production or higher-volume use should use a personal token. Calculations come from the same engine as the ROFilter web application, but designs should be checked against the manufacturer’s official software before delivery.

The stdio package is a bridge to the hosted service rather than a standalone offline calculation engine. Direct HTTP use also requires network access to rofilter.cn. Keep tokens in client environment settings or request headers rather than placing them in prompts or source files.

_Full upstream README: https://allmcps.com/mcp/rofilter/readme_