Wellness Pulse

---

🧠 什么是 Wellness Pulse MCP？

Wellness Pulse MCP 是一个 Model Context Protocol（MCP）服务，旨在弥合原始健康福祉数据与 AI 驱动的理解之间的鸿沟。

只需一次集成，你的 AI 即可访问：

• 📊 CDC PLACES 公共基准数据——美国任意邮政编码或县的可信心理健康数据
• 🏢 机构健康福祉信号——来自所在机构 Wellness Pulse 数据的实时趋势、快照和警报检查
• 🗣️ 通俗易懂的说明——与结构化 JSON 一同返回的 AI 就绪摘要

专为副驾驶、自动化和 AI 仪表板中的快速**“提问 → 回答”**工作流而构建——无需人工分析。

---

✨ 团队为何接入 Wellness Pulse MCP

能力	可实现的功能
📖 即时叙述	AI 可解释*“发生了什么变化以及为何重要”*，无需人工分析师参与。
📍 CDC 基准数据	提供县级心理困扰背景信息，可用于营销演示文稿、报告和资助申请。
📡 实时机构信号	每日趋势 + 警报检查，可在健康福祉状况下滑演变为危机前及时发现。
🔌 一次集成	只需接入一次 MCP，即可在团队使用的所有副驾驶、Agent 和仪表板中重复使用。
🔒 隐私优先	不跟踪用户，不收集标识符。深受重视隐私的机构信赖。

---

🏗️ 架构概览

---

🛠️ 可用工具

🌍 公共基准工具

get_mental_health_benchmark

获取指定 ZIP 码或县 FIPS 代码对应的 CDC PLACES **频繁心理困扰（FMD）**数据。

参数：

参数	类型	必填	说明
zip	string	可选*	5 位美国 ZIP 码
county_fips	string	可选*	县 FIPS 代码

zip 和 county_fips 至少填写一项。

返回： scope、values、national_percentile_rank（可选）、marketing_copy

示例用例： “ZIP 码 94597 对应的 CDC 心理困扰基准是多少？”

---

get_basic_alert_guidance

根据组织规模和地点类型返回默认提醒阈值，无需机构 ID。

参数：

参数	类型	必填	说明
org_size	string	✅	例如 "small"、"medium"、"large"
location_type	string	✅	例如 "urban"、"rural"、"suburban"

示例用例： “中型郊区机构应该使用什么提醒阈值？”

---

🏢 机构数据工具

这些工具需要提供 Wellness Pulse 账户中的有效机构标识符（institution_id）。

get_institution_snapshot

获取指定时间窗口内机构健康状况数据的时间点快照。

参数：

参数	类型	必填	说明
institution_id	string	✅	你的 Wellness Pulse 机构 ID
window_days	integer	✅	回溯天数（例如 30、90）

返回： response_count、avg_wellness_score、last_response_at

---

get_institution_trend_daily

获取健康评分和回复数量的每日时间序列。

参数：

参数	类型	必填	说明
institution_id	string	✅	你的 Wellness Pulse 机构 ID
window_days	integer	✅	包含的天数

返回： { day, avg_wellness, responses } 对象数组

示例用例： “我们过去 90 天的健康趋势如何？”

---

get_institution_alert_check

比较最近 7 天与此前 7 天的数据，并标记显著下降。

参数：

参数	类型	必填	说明
institution_id	string	✅	你的 Wellness Pulse 机构 ID

返回： drop_pct、alert（布尔标志）

示例用例： “我们的数据是否周环比下降？需要担心吗？”

---

get_sector_snapshot

跨机构汇总的行业级健康数据。

参数：

参数	类型	必填	说明
sector	string	✅	行业标识符
window_days	integer	✅	回溯天数

返回： institutions_with_responses、total_responses、avg_wellness_score

---

🚀 开始使用

第 1 步 — 添加到你的 AI 客户端

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "Wellness Pulse": {
      "url": "https://wpulse.org/mcp/",
      "transport": "http-stream"
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "Wellness Pulse": {
      "url": "https://wpulse.org/mcp/",
      "transport": "http-stream"
    }
  }
}

---

第 2 步 — 初始化会话（通过 cURL）

curl -s https://wpulse.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "my-app", "version": "1.0.0" }
    }
  }'

📌 从响应标头中获取 mcp-session-id — 后续所有调用都会用到它。

---

第 3 步 — 列出可用工具

curl -s https://wpulse.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <YOUR_SESSION_ID>" \
  -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }'

---

第 4 步 — 调用工具

示例：获取 ZIP 码对应的 CDC 基准

curl -s https://wpulse.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <YOUR_SESSION_ID>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "get_mental_health_benchmark",
      "arguments": { "zip": "94597" }
    }
  }'

示例：检查机构提醒状态

curl -s https://wpulse.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <YOUR_SESSION_ID>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "get_institution_alert_check",
      "arguments": { "institution_id": "inst_abc123" }
    }
  }'

---

💬 可以向 AI 提出的示例提示词

连接 Wellness Pulse MCP 后，可以试着向 AI 提问：

"What's our wellness trend for the last 90 days?"
"Did we drop week-over-week? Why might that matter?"
"What's the CDC mental distress benchmark for ZIP 94597?"
"Write a short exec update with our wellness numbers and CDC context."
"Are we above or below the national average for mental distress?"
"Flag any alert conditions in our institution data this week."
"Summarize the sector snapshot and highlight any outliers."

---

🔌 端点参考

类型	URL
HTTP Stream（规范端点）	https://wpulse.org/mcp/
HTTP Stream（重定向）	https://wpulse.org/mcp
SSE	https://wpulse.org/sse

HTTP Streaming 所需标头：

Content-Type: application/json
Accept: application/json, text/event-stream

所有调用均使用 JSON-RPC 2.0。

---

🔐 隐私与安全

Wellness Pulse MCP 采用隐私优先架构：

• ✅ 不追踪用户，也不记录用户行为
• ✅ 不存储或传输个人身份信息（PII）
• ✅ 机构数据按账户划定范围并进行访问控制
• ✅ 所有传输均通过 HTTPS
• ✅ 专为注重合规的环境设计（医疗保健、教育、人力资源）

---

🗺️ 使用场景

🏥 医疗保健与员工健康团队

使用每日趋势监测和逐周预警检查，在倦怠或心理困扰信号升级前及时发现，并按需为临床或人力资源管理层提供 AI 生成的执行摘要。

🎓 大学与教育机构

将 CDC 县级基准数据与学生健康调查数据结合，根据区域常态对分数进行背景分析，适用于认证报告和学生事务演示。

📈 HR 技术与健康平台

将 Wellness Pulse MCP 嵌入现有的 copilot 或仪表板产品，即时补充经过基准对比的心理健康背景信息和趋势解读，无需构建自己的数据管道。

📢 公共卫生传播

按邮政编码或县提取 CDC PLACES FMD 数据，生成以权威公共数据为依据的营销文案、拨款申请内容和社区健康报告。

🤖 AI Agent 与自动化

将 Wellness Pulse MCP 接入多步骤 Agent，定期检查预警条件、起草利益相关方更新内容并分派升级事项，全程无需人工参与分析。

---

📚 资源

• 🌐 网站： wpulse.org
• 📖 MCP 协议文档： modelcontextprotocol.io
• 📊 CDC PLACES 数据： cdc.gov/places
• 🐛 问题 / 支持： wpulse.org

---

📄 许可证

此服务采用机构许可证。有关许可详情和机构访问权限，请访问 wpulse.org。

---