ROFilter - RO Membrane System Design

rofilter

ROFilter（rofilter.cn）是一款反渗透膜系统设计软件，内置 742 件膜元件库（覆盖威立雅、杜邦、东丽、LG、海德能、CSM、沃顿、澳维 8 大品牌）、进水水质分析（TDS / 渗透压 / LSI / 碳酸平衡）、结垢评估与完整多段系统设计（进水压力 / 产水 TDS / 能耗 / 逐段通量）。本包是它的 MCP 接入能力，让 AI 助手直接调用同一套计算引擎。

npm 包：rofilter（npx -y rofilter 即用）

工具

查询与评估类工具免费，run_design 计费（每天免费额度）。

---

各 Agent / 客户端接入指南

统一原理：rofilter 包提供 stdio MCP 服务器（rofilter-mcp）；也可以跳过本地进程直接 Streamable HTTP 连 https://rofilter.cn/mcp。

1. 豆包 / 扣子（Coze）

方式 A：MCP 插件（推荐，工具实时可用）

扣子 / Coze Studio → 插件 → 创建插件 → 选 MCP → 选 npm：

包名: rofilter

命令: rofilter-mcp

Coze 会自动 npx 拉起包内 bin/rofilter-mcp，无需预装。若平台要求填写启动参数，留空即可；需要令牌时在环境变量里填 ROFILTER_TOKEN。

方式 B：技能（Skill）导入

扣子 → 技能 → 创建技能 → 导入 zip → 上传：

skills/rofilter-mcp-skill-flat.zip

扁平包（zip 根目录直接是 SKILL.md + references/）。技能内含完整调用指引；工具调用仍需在空间里配置上面的 MCP 插件。

2. 通义千问（Qwen）

Qwen Code CLI

编辑 ~/.qwen/settings.json（Linux/macOS）或 %USERPROFILE%\.qwen\settings.json（Windows）：

{

"mcpServers": { "rofilter": { "command": "npx", "args": ["-y", "rofilter"], "env": { "ROFILTER_TOKEN": "rfmcp_你的令牌" } } } }

之后在 Qwen Code 里直接问："用 ROFilter 算一下 ESPA2-LD 100 支容器产水 100 m³/h 的进水压力"。

通义 / 百炼平台（应用编排）

应用编辑器 → 插件 / MCP 服务 → 添加 MCP 服务 → 填 Streamable HTTP：

URL:   https://rofilter.cn/mcp

Header: Authorization: Bearer rfmcp_你的令牌

3. WorkBuddy

WorkBuddy → MCP 服务器 / 工具 设置 → 添加自定义 MCP（stdio）：

命令:      npx

参数: -y rofilter 环境变量: ROFILTER_TOKEN = rfmcp_你的令牌

若 WorkBuddy 支持远程 MCP，可改用 HTTP：https://rofilter.cn/mcp + Bearer 头。

4. Claude（Desktop / Claude Code）

Claude Desktop

claude_desktop_config.json：

{

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

Claude Code

claude mcp add rofilter -- npx -y rofilter

带令牌：

claude mcp add rofilter --env ROFILTER_TOKEN=rfmcp_你的令牌 -- npx -y rofilter

作为技能（Agent Skill）安装

下载 skills/rofilter-mcp-skill.zip（标准布局：rofilter-design/SKILL.md），放进项目的 .claude/skills/ 或用户级 skills 目录后重启。

5. Cursor / Windsurf / Zed / Gemini CLI 等

Cursor（~/.cursor/mcp.json）：

{

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

Windsurf（~/.codeium/windsurf/mcp_config.json）：

{

"mcpServers": { "rofilter": { "command": "npx", "args": ["-y", "rofilter"], "env": { "ROFILTER_TOKEN": "rfmcp_你的令牌" } } } }

Gemini CLI（~/.gemini/settings.json）：

{

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

6. DeepSeek Harness（DSH）一键插件

左侧栏 插件 → 添加插件 → 粘贴包名 rofilter → 安装 → 立即启用。 包内 cordis.patch.yml 自动把自带的 @deepseek-ai/dsh-mcp-client 挂到远程端点。

命令行注意：只用 dsh plugin add rofilter 不够——那条命令只装依赖，不会把组合包选进 dsh.profile.bundles；走界面的「安装」会把两步一起做掉。

7. 任意 MCP 客户端（stdio / HTTP 二选一）

stdio（本地进程桥接）：

命令:  npx -y rofilter        （等价 bin 命令: rofilter-mcp）

env: ROFILTER_TOKEN = rfmcp_你的令牌 （可选）

Streamable HTTP 直连（免本地进程）：

端点:   https://rofilter.cn/mcp

请求头: Authorization: Bearer rfmcp_你的令牌

---

Skill 包（技能 zip）

仓库 skills/ 目录提供两种布局（内容相同：SKILL.md 工作流 + 3 份参考资料 access / design-tuning / water-quality）：

校验报错排查：早期版本的 zip 在 Windows 下被打成反斜杠路径（rofilter-design\SKILL.md），平台解压后识别不到 SKILL.md。2026-11 起两个 zip 均为 ZIP 规范的正斜杠路径；线上下载（rofilter.cn/static/downloads/）始终是修复后的版本。

令牌

包内自带共享试用令牌（全站 1000 次/天，次日恢复）。正式使用请到 rofilter.cn 免费注册，在「个人设置 → MCP 接入」生成专属令牌：

# stdio 模式

ROFILTER_TOKEN=rfmcp_你的令牌 npx -y rofilter # Linux/macOS

PowerShell: $env:ROFILTER_TOKEN='rfmcp_…'; npx -y rofilter

HTTP 模式直接把令牌放进 Authorization: Bearer … 头。

工作原理

stdio MCP 服务器（bin/rofilter-mcp.js，零依赖，Node ≥ 18 内置 fetch）把 rofilter.cn 托管的 Streamable HTTP MCP 端点桥接为 stdio：initialize / tools/list / tools/call 逐条转发，自动维护 Mcp-Session-Id，兼容 JSON 与 SSE 两种响应。

计算引擎与 rofilter.cn 网页端同源同数值；交付前建议用厂商官方软件复核。

仓库结构

bin/rofilter-mcp.js            stdio MCP 服务器（npm bin 入口）

skills/SKILL.md skill 源（标准 Agent Skills 格式） skills/references/ 参考资料（接入/调参/水质） skills/rofilter-mcp-skill*.zip 两种布局的技能包 cordis.patch.yml DeepSeek Harness 组合包配置 locale/ DSH 插件元数据（中/英） icon.svg 插件图标 server.json / plugin-market.json MCP 注册表 / DSH 市场索引 docs-mcp-guide*.html rofilter.cn 端 MCP 接入指南快照

English

ROFilter is a reverse-osmosis membrane system design software (rofilter.cn) with a 742-element library across 8 brands (Veolia, DuPont, Toray, LG, Hydranautics, CSM, Vontron, Ovay), feed-water analysis, scaling assessment, and full multi-stage system design. This package is its MCP integration — one package, many clients:

• stdio MCP (Coze/Doubao, Qwen, WorkBuddy, Claude, Cursor, Windsurf, Gemini CLI…): command: npx, args: ["-y", "rofilter"], env ROFILTER_TOKEN.
• Streamable HTTP: https://rofilter.cn/mcp with Authorization: Bearer rfmcp_….
• DeepSeek Harness bundle: install rofilter from the Plugins panel.
• Agent Skills: two zips under skills/ (standard rofilter-design/SKILL.md layout and a flat layout whose root is SKILL.md) with full workflow references.

Zero dependencies (Node ≥18). Ships a shared trial token (1,000 run_design calls/day); generate your own at rofilter.cn → Settings → MCP access.

License

MIT. See LICENSE.

AI生成