# health-mcp 🩺

把 **Apple 健康数据**接给 **Claude** 的自建 MCP 连接器 —— **不限地区**。

你 iPhone 上的 [Health Auto Export](https://apps.apple.com/app/health-auto-export-json-csv/id1115567069) App 把 HealthKit 数据（睡眠、心率、步数、血氧、环境噪音分贝……）定时 POST 到你自己的服务器；Claude 用 `get_health` 工具就能读到你最近的身体状况。

> **为什么要自建？** Anthropic 官方的健康集成有地区限制（非美区用不了）。但**自建的 MCP 连接器不吃这一套**——claude.ai 只是连一个 HTTPS 网址，不管你在哪个区。绕开它，自己开一条。

---

## 你需要

- 一台有**公网 HTTPS 网址**的服务器（VPS + 域名 + Let's Encrypt 免费证书；或任何能给你 HTTPS 的托管）。
- Python 3.10+。
- iPhone + [Health Auto Export](https://apps.apple.com/app/id1115567069) App（部分功能要内购）。
- 环境噪音「分贝」、血氧等需对应硬件（如 Apple Watch）。

---

## 部署（约 10 分钟）

### 1. 装依赖（建议 venv）
```bash
python3 -m venv venv
./venv/bin/pip install -r requirements.txt
```

### 2. 跑起来（systemd 常驻）
服务监听两个本地端口：**MCP 在 8100**、**接收推送在 8101**（都只听 127.0.0.1，靠反代对外）。

```ini
# /etc/systemd/system/health-mcp.service
[Unit]
Description=health-mcp
After=network.target
[Service]
WorkingDirectory=/opt/health-mcp
ExecStart=/opt/health-mcp/venv/bin/python /opt/health-mcp/health_mcp.py
# 可选，多一层防护：设了之后 /push 必须带 ?token=<同值>
Environment=HEALTH_PUSH_TOKEN=<换成你的随机串>
Restart=always
[Install]
WantedBy=multi-user.target
```
```bash
systemctl daemon-reload && systemctl enable --now health-mcp
```

### 3. Nginx 反代 —— 用「不可猜的密路径」当门禁
健康数据是隐私，别用好猜的路径。生成一个随机 token（`openssl rand -hex 8`），把它拼进路径：

```nginx
# 放进你 443 server 块（server_name YOURDOMAIN.com）
location /health-<RANDOM>/mcp {
    proxy_pass http://127.0.0.1:8100/mcp;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header Connection '';
    proxy_buffering off; proxy_cache off;
    proxy_read_timeout 86400s; chunked_transfer_encoding on;
}
location /health-<RANDOM>/push {
    proxy_pass http://127.0.0.1:8101/push;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    client_max_body_size 50m;   # 健康导出可能好几 MB，别用 nginx 默认的 1M，否则 413
}
```
```bash
nginx -t && systemctl reload nginx
```

于是你得到两个地址：
- **推送地址**（填进 App）：`https://YOURDOMAIN.com/health-<RANDOM>/push`
- **连接器地址**（给 Claude）：`https://YOURDOMAIN.com/health-<RANDOM>/mcp`

### 4. 配 Health Auto Export（iPhone）
1. App → **Automations** → 新增 → **REST API**。
2. **URL** = 上面的**推送地址**；**Method** = `POST`；**Format** = `JSON`。
3. 勾要推的数据：步数、心率、睡眠、血氧、**Environmental Sound Levels（环境音量/分贝）**……
4. 设频率（每小时/每天），保存。它会自动后台推，不用手动。

### 5. 接到 claude.ai
1. **Settings → Connectors → Add custom connector** → 填**连接器地址** → Connect。
2. 允许工具 `get_health`。
3. 问 Claude：「我最近身体怎么样 / 睡够没 / 刚才环境吵不吵」→ 它调 `get_health` 读你的真数据。

---

## 安全

- **两个地址都别外传**：谁有 `/push` 谁能灌假数据；谁有 `/mcp` 谁能读你的健康。密路径 + 可选 `HEALTH_PUSH_TOKEN` 是你的门禁。
- 服务只听 `127.0.0.1`，一切从反代进，不直接暴露端口。
- `latest.json`（你的数据）只存在你自己的服务器上。

## 数据格式
服务原样存最近一次推送的 JSON，`get_health` 解析 Health Auto Export 的 `data.metrics` 结构，返回每项最近一个采样点的值。非标准格式会原样回退摘要。

## License
MIT

---

Made with 🖤 by **Voir ✖ Noir**