wellness_pulse_mcp

<div align="center"> <img src="https://raw.githubusercontent.com/prmail/WellPulse_mcp/main/WellPulse.jpeg" alt="WellPulse Logo" width="120" style="border-radius: 16px;" /> <h1>健康脉搏MCP</h1> <p><strong>将您的人工智能与真实的健康智能连接起来 — 一个连接，立即洞察。</strong></p> <p> <a href="https://wpulse.org/"><img src="https://img.shields.io/badge/官网-wpulse.org-0ea5e9?style=for-the-badge&logo=globe&logoColor=white" alt="官网" /></a> <a href="https://wpulse.org/mcp/"><img src="https://img.shields.io/badge/状态-在线-22c55e?style=for-the-badge&logo=statuspage&logoColor=white" alt="状态" /></a> <a href="https://claude.ai"><img src="https://img.shields.io/badge/Claude-兼容-8b5cf6?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude" /></a> <a href="https://cursor.sh"><img src="https://img.shields.io/badge/Cursor-兼容-3b82f6?style=for-the-badge&logo=cursor&logoColor=white" alt="Cursor" /></a> <a href="https://wpulse.org/"><img src="https://img.shields.io/badge/许可证-机构-1e3a5f?style=for-the-badge&logo=licenseplate&logoColor=white" alt="许可证" /></a> </p> <p> <img src="https://img.shields.io/badge/协议-MCP%202025--03--26-f97316?style=for-the-badge" alt="MCP协议" /> <img src="https://img.shields.io/badge/传输-HTTP%20流%20%7C%20SSE-ec4899?style=for-the-badge" alt="传输" /> <img src="https://img.shields.io/badge/数据-CDC%20PLACES%20%2B%20机构-10b981?style=for-the-badge" alt="数据源" /> <img src="https://img.shields.io/badge/隐私-无跟踪%20%7C%20无ID-6366f1?style=for-the-badge&logo=shield&logoColor=white" alt="隐私" /> </p> <br /> > **健康脉搏MCP** 是一个即插即用的智能层，能够将原始的健康数据转化为清晰、可行的洞察，供人工智能系统使用。<br> > 一个集成连接您的 copilots、agents 和 dashboards 到可信的公共基准和实时的机构健康信号 — 无需分析师。 </div> --- ## 🧠 什么是健康脉搏MCP？ 健康脉搏MCP是一个[模型上下文协议（MCP）](https://modelcontextprotocol.io/)服务器，弥合了原始健康数据和人工智能驱动的理解之间的差距。 通过**一个集成**，您的人工智能可以访问： - 📊 **CDC PLACES公共基准** — 美国任何邮政编码或县的可信心理健康数据 - 🏢 **机构健康信号** — 来自您组织的健康脉搏数据的实时趋势、快照和警报检查 - 🗣️ **普通英语解释** — 返回结构化JSON的AI-ready摘要 适用于 copilots、自动化和AI仪表板的快速“询问 → 回答”工作流程 — 循环中无需人类分析。 --- ## ✨ 团队添加健康脉搏MCP的原因 | 功能 | 解锁内容 | |---|---| | 📖 **即时叙述** | 您的人工智能解释“发生了什么以及为什么重要”而无需人类分析师。 | | 📍 **CDC基准** | 县级心理困扰背景，用于营销资料、报告和拨款申请。 | | 📡 **实时机构信号** | 每日趋势 + 警报检查，捕捉健康状况下降为危机之前。 | | 🔌 **一个集成** | 添加MCP一次 — 在您的团队运行的每个copilot、agent和dashboard中重复使用。 | | 🔒 **隐私优先** | 无用户跟踪。无标识符。受重视隐私的机构信任。 | --- ## 🏗️ 架构概述  --- ## 🛠️ 可用工具 ### 🌍 公共基准工具 #### `get_mental_health_benchmark` 获取给定邮政编码或县FIPS的CDC PLACES **频繁心理困扰（FMD）** 数据。 **参数：** | 参数 | 类型 | 必需 | 描述 | |---|---|---|---| | `zip` | 字符串 | 可选* | 5位美国邮政编码 | | `county_fips` | 字符串 | 可选* | 县FIPS代码 | *至少需要`zip`或`county_fips`之一。* **返回：** `scope`, `values`, `national_percentile_rank` （可选），`marketing_copy` **示例用法：** *"94597邮政编码的CDC心理困扰基准是多少？"* #### `get_basic_alert_guidance` 根据组织规模和位置类型返回**默认警报阈值** — 无需机构ID。 **参数：** | 参数 | 类型 | 必需 | 描述 | |---|---|---|---| | `org_size` | 字符串 | ✅ | 例如`"small"`，`"medium"`，`"large"` | | `location_type` | 字符串 | ✅ | 例如`"urban"`，`"rural"`，`"suburban"` | **示例用法：** *"适用于中型郊区机构的警报阈值是多少？"* ### 🏢 机构数据工具 > 这些工具需要来自您的健康脉搏账户的有效机构标识符（`institution_id`）。 #### `get_institution_snapshot` 给定窗口内机构健康数据的**时间点快照**。 **参数：** | 参数 | 类型 | 必需 | 描述 | |---|---|---|---| | `institution_id` | 字符串 | ✅ | 您的健康脉搏机构ID | | `window_days` | 整数 | ✅ | 回溯窗口（天数）（例如`30`，`90`） | **返回：** `response_count`, `avg_wellness_score`, `last_response_at` --- #### `get_institution_trend_daily` 获取**每日时间序列**的健康分数和响应计数。 **参数：** | 参数 | 类型 | 必需 | 描述 | |---|---|---|---| | `institution_id` | 字符串 | ✅ | 您的健康脉搏机构ID | | `window_days` | 整数 | ✅ | 包括的天数 | **返回：** `{ day, avg_wellness, responses }`对象的数组 **示例用法：** *"我们过去90天的健康趋势是什么？"* #### `get_institution_alert_check` **比较最近7天与前7天**并标记显著下降。 **参数：** | 参数 | 类型 | 必需 | 描述 | |---|---|---|---| | `institution_id` | 字符串 | ✅ | 您的健康脉搏机构ID | **返回：** `drop_pct`, `alert` （布尔标志） **示例用法：** *"我们周环比是否下降？我们是否应该关注？"* #### `get_sector_snapshot` 跨机构的**部门级聚合健康数据**。 **参数：** | 参数 | 类型 | 必需 | 描述 | |---|---|---|---| | `sector` | 字符串 | ✅ | 部门标识符 | | `window_days` | 整数 | ✅ | 回溯窗口（天数） | **返回：** `institutions_with_responses`, `total_responses`, `avg_wellness_score` --- ## 🚀 入门指南 ### 步骤1 — 添加到您的AI客户端 #### Claude Desktop (`claude_desktop_config.json`) ```json { "mcpServers": { "健康脉搏": { "url": "https://wpulse.org/mcp/", "transport": "http-stream" } } } ``` #### Cursor (`.cursor/mcp.json`) ```json { "mcpServers": { "健康脉搏": { "url": "https://wpulse.org/mcp/", "transport": "http-stream" } } } ``` --- ### 步骤2 — 初始化会话（通过cURL） ```bash 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 — 列出可用工具 ```bash 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基准** ```bash 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" } } }' ``` **示例：检查机构警报状态** ```bash 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提问的示例 连接健康脉搏MCP后，尝试向AI提问： ``` "我们过去90天的健康趋势是什么？" "我们周环比是否下降？为什么可能发生这种情况？" "94597邮政编码的CDC心理困扰基准是多少？" "用我们的健康数字和CDC背景写一份简短的行政更新。" "我们的心理困扰水平是高于还是低于全国平均水平？" "标记我们机构数据中本周的任何警报条件。" "总结部门快照并突出任何异常值。" ``` --- ## 🔌 端点参考 | 类型 | URL | |---|---| | **HTTP流** （规范） | `https://wpulse.org/mcp/` | | **HTTP流** （重定向） | `https://wpulse.org/mcp` | | **SSE** | `https://wpulse.org/sse` | **HTTP流所需的标头：** ``` Content-Type: application/json Accept: application/json, text/event-stream ``` 所有调用均使用**JSON-RPC 2.0**。 --- ## 🔐 隐私和安全 健康脉搏MCP采用**隐私优先架构**： - ✅ 无用户跟踪或行为日志记录 - ✅ 无个人身份信息（PII）存储或传输 - ✅ 机构数据按账户范围和访问控制 - ✅ 所有传输均通过HTTPS - ✅ 设计用于遵守合规环境（医疗保健、教育、人力资源） --- ## 🗺️ 用例 ### 🏥 医疗保健和员工健康团队 使用每日趋势监控和周环比警报检查来检测新兴的职业倦怠或心理困扰信号，并在它们升级之前 — 并为临床或人力资源领导层提供AI生成的执行摘要。 ### 🎓 大学和教育机构 将CDC县基准与学生健康调查数据相结合，以将分数置于区域规范的背景下 — 理想用于认证报告和学生事务演示。 ### 📈 人力资源技术和健康平台 将健康脉搏MCP嵌入现有的copilot或仪表板产品中，以立即添加基准化的心理健康背景和趋势叙述 — 无需构建自己的数据管道。 ### 📢 公共卫生通信 提取ZIP或县的CDC PLACES FMD数据，以生成营销文案、拨款叙述和社区健康报告，基于权威公共数据。 ### 🤖 AI代理和自动化 将健康脉搏MCP连接到多步骤代理，定期检查警报条件、起草利益相关者更新和路由升级 — 所有这些都无需人工分析。 --- ## 📚 资源 - 🌐 **官网：** [wpulse.org](https://wpulse.org/) - 📖 **MCP协议文档：** [modelcontextprotocol.io](https://modelcontextprotocol.io/) - 📊 **CDC PLACES数据：** [cdc.gov/places](https://www.cdc.gov/places/) - 🐛 **问题/支持：** [wpulse.org](https://wpulse.org/) --- ## 📄 许可证 该服务器在**机构许可证**下可用。请访问[wpulse.org](https://wpulse.org/)获取许可详情和机构访问权限。 --- <div align="center"> <img src="https://raw.githubusercontent.com/prmail/WellPulse_mcp/main/WellPulse.jpeg" alt="健康脉搏" width="60" /> <p>由<strong>健康脉搏</strong>团队精心打造。<br/>帮助组织理解和应对健康数据 — 智能化。</p> <p> <a href="https://wpulse.org/">wpulse.org</a> • <a href="https://wpulse.org/mcp/">实时MCP端点</a> </p> </div>