withings-mcp

用于 Withings Health API 的 MCP 服务器，具备 OAuth、本地 SQLite 缓存和趋势分析功能。

此服务器与其他 Withings MCP 服务器的区别：

• 本地 SQLite 缓存，用于快速离线查询和历史趋势分析

• 增量同步 - 仅获取自上次同步以来的新数据

• 支持所有 200 多种 Withings 测量类型（身体成分、睡眠、活动、锻炼、心电图）

• 自动 OAuth 令牌刷新（访问令牌：3 小时，刷新令牌：1 年）

• 除 mcp 外零依赖（使用标准库进行 HTTP 通信）

• Python 3.13+

工具

Related MCP server: Withings MCP Server

先决条件

• Python 3.13+

• uv（推荐）或 pip

• Withings 开发者账户和已注册的应用程序

安装

git clone https://github.com/partymola/withings-mcp.git
cd withings-mcp
uv venv --python 3.13 .venv
uv pip install -e .

设置

1. 注册 Withings 应用

1. 前往 https://developer.withings.com/dashboard

2. 创建一个新应用

3. 将回调 URL 设置为 http://localhost:8585

4. 记录您的 Client ID 和 Client Secret

2. 身份验证

.venv/bin/withings-mcp auth

这将打开浏览器进行 Withings 授权。批准后，令牌将保存在本地的 config/ 目录中。

3. 在 Claude Code 中注册

claude mcp add -s user withings -- /path/to/withings-mcp/.venv/bin/withings-mcp

4. 首次同步

在 Claude Code 中输入：“Sync my Withings data”

这将运行 withings_sync 来填充本地缓存。后续同步仅会获取新数据。

配置

示例提示词

• “Sync my Withings data”

• “Show my weight for the last 3 months”

• “How has my sleep changed this year?”

• “Compare my body composition this month vs last month”

• “What workouts did I do in March?”

• “What Withings devices do I have connected?”

• “Show my sleep trends quarterly”

开发

# Install with dev dependencies
uv pip install -e . && uv pip install pytest

# Run tests (74 tests, all use in-memory SQLite with fictional data)
.venv/bin/python -m pytest tests/ -v

安全性

• 只读：没有任何工具会修改 Withings 服务器上的数据

• 本地存储：健康数据保留在您的本地 SQLite 数据库中

• 令牌存储：OAuth 令牌存储在 config/ 中（已加入 gitignore，文件权限为 0600）

• 错误消息：绝不包含健康数据值 - 仅包含状态码

• 预提交钩子 (Pre-commit hook)：拒绝将数据库文件和凭据提交到代码库

贡献

请参阅 CONTRIBUTING.md 了解开发设置、测试工作流程和预提交钩子。变更记录在 CHANGELOG.md 中。

许可证

GPL-3.0-or-later