MCP 数据服务

把 MCP 数据服务接进你的 AI 助手，就可以直接用自然语言查询你被授权的排水监测数据：项目、点位、设备、最新数据和历史时序，全部只读。

MCP 数据服务把 THWater 平台上的监测数据接给 AI 助手。你只要在支持 MCP 的客户端里填一个地址、用 THWater 账号登录一次，之后就可以像聊天一样查数据——不用写 SQL，也不用调接口。

服务是只读的：它能回答"数据是多少"，不能修改任何数据。你能看到的内容，取决于管理员给你的账号授权了哪些项目。

你能用它做什么

• 看家底：我有哪些项目？某个项目有多少点位和设备？数据新不新鲜（多少台在线、多少台长时间没数据）？
• 看现场：某个点位现在什么情况？哪台设备装在这里？最新的液位、流量、水质、雨量是多少？
• 看变化：某台设备最近 2 小时的液位变化？某天 0 点到 6 点的流量曲线？
• 看历史：这台设备以前装在哪个点位？（迁装记录会保留，历史数据按当时的点位查询）
• 做汇总：让助手把查到的数据整理成表格、算均值/峰值、列出数据陈旧的设备清单。

三步开始

1. 在支持 MCP 的客户端里添加服务器地址：https://dev.thuwater.com/mcp/data；
2. 首次连接会返回 401，客户端自动打开浏览器跳到 THWater 的 SSO 登录页，用你的账号登录并同意授权（令牌 15 分钟有效，客户端会自动续期，无需手工维护）；
3. 直接提问，例如"我现在能看哪些项目？"或"北京路雨水管这个点位现在的液位是多少？"。

{
  "mcpServers": {
    "thwater-data": {
      "type": "streamable-http",
      "url": "https://dev.thuwater.com/mcp/data"
    }
  }
}

示例效果

下面是几个日常提问与回答的示例，帮助你直观了解它能做什么：

数据范围与权限

• 账号：使用你的 THWater 账号登录即可，无需单独申请密码；但必须先被管理员开通 MCP 数据权限，否则登录成功也查不到数据；
• 项目范围：只能看到授权给你的项目及其点位、设备、数据，跨项目查询会被拒绝；
• 只读：不提供任何写入能力；
• 时区：所有时间按 Asia/Shanghai（+08:00）解释和返回；
• 调用限制：服务端对调用频率与并发有限制，超限会返回 429，客户端稍后重试即可；
• 数据时效：项目总览会给出"新鲜/陈旧/无快照"的判定（默认以 24 小时为陈旧阈值），便于你先判断数据能不能用。

接下来