Plutocalc Designer MCP 服务器

关键词

水处理设计模型计算设计模板API 桥接工程工具

使用说明内容（Markdown格式）

  • 项目简介

    • 这是一个 MCP 风格的服务器实现，作为后端服务桥接 Plutocalc Designer 的 REST API，为 AI 客户端提供资源列表、工具调用、模型信息与模板等能力，并以 MCP 的形式对接客户端。

  • 主要功能点

    • 提供健康、信息与工具清单接口，方便客户端探知服务能力
    • 支持多种模型相关操作：列出模型、获取模型信息、获取模板、获取引用数据库、获取单位列表
    • 支持模型计算：将输入模板发送给 Plutocalc 的计算接口，返回计算结果
    • 提供模板与文档转换功能：JSON 转 Markdown、Markdown 转 JSON
    • 获取模型手册链接与许可证相关帮助信息
    • 具备基础的安全与性能保障：HTTP 接口、速率限制、CORS、Helmet 头部安全设置
    • 作为 MCP 注册服务器，支撑 MCP 客户端的“server name、command、args”等启动配置信息

  • 安装步骤

    • 克隆仓库并进入项目目录
    • 安装依赖：npm install
    • 启动服务器：npm start
    • 服务器默认运行端口是 3003（可通过 PORT 环境变量修改）
    • 服务器根路径为 /designer/mcp，示例健康接口为 http://localhost:3003/designer/mcp/health

  • 服务器配置（MCP 客户端准备的启动信息，示例为 JSON 格式，具体字段需结合客户端实现）

    • 服务器名称（server name）：plutocalcdesigner
    • 启动命令（command）：npm
    • 启动参数（args）：start
    • 环境变量（env，可选）
      • PORT: "3003"
      • BASE_PATH: "/designer/mcp"
      • PLUTOCALC_API_BASE_URL: "https://www.plutocalc.com/designer/server"
    • 说明：该配置表示通过 npm start 启动服务器，监听 3003 端口，MCP 客户端通过 /designer/mcp 路径访问，底层对接 Plutocalc Designer API 的基础地址为 https://www.plutocalc.com/designer/server

  • 基本使用方法

    • 启动后，MCP 客户端可向以下端点发起请求：
      • GET /health 进行健康检查
      • GET /info 获取服务器信息与工具列表
      • GET /tools 获取全部工具元信息
      • POST /tools/{toolName} 传入工具所需参数，执行对应操作（如 list_models、get_model、compute_model 等）
    • 注意：调用 compute_model 等需要 provide model 与 input 模板等必要字段，返回格式包含 content 字段，便于在 MCP 客户端解析显示

服务器信息

访问项目