AI导哈

生物传感数据AI分析服务

通过Model Context Protocol (MCP)将Sensor Bio可穿戴设备数据连接到Claude、ChatGPT等AI助手，实现健康数据分析与查询。

  • by GetSensr-io
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Biostrap/sensorbio-mcp-server-python

使用说明

传感器生物MCP服务器

使用以下工具将Sensor Bio可穿戴数据连接到Claude、ChatGPT和其他人工智能助手 模型上下文协议（MCP）.

问你的AI助手一些事情，比如 “我上周睡得怎么样？”, “我的静息心率趋势是什么？”，或 “显示我过去一个月的恢复分数” 并直接从您的传感器生物数据中获取答案。

快速开始

1.获取您的API代币

登录到您的 Sensor Bio开发者门户 抓住你的 组织API代币.

2.安装uv

此服务器使用 紫外线 跑步。只需一个命令即可安装：

Mac/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3.添加到克劳德桌面

打开您的Claude Desktop配置文件：

操作系统 路径
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
窗户 %APPDATA%\Claude\claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json

添加（或合并到） mcpServers 章节：

{
  "mcpServers": {
    "sensorbio": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/GetSensr-io/sensorbio-mcp-server",
        "sensorbio-mcp-server"
      ],
      "env": {
        "SENSR_ORG_TOKEN": "paste-your-token-here"
      }
    }
  }
}

4.重新启动克劳德桌面

退出并重新打开Claude Desktop。您应该在MCP工具列表中看到“sensorbio”（查找锤子图标）。

5.试试看

问克劳德这样的问题：

“显示我过去一周的睡眠数据”

“我昨天燃烧了多少卡路里？”

“列出我组织中的所有用户”

其他MCP客户端

光标/风帆

这些编辑器本机支持MCP服务器。在各自的MCP设置中使用上述相同的配置格式。

OpenAI（ChatGPT）

ChatGPT中的MCP支持正在推出。如果可用，相同的服务器和配置模式将工作。

任何MCP客户端

任何支持 模型上下文协议 可以使用此服务器进行连接。只需将其指向：

uvx --from git+https://github.com/GetSensr-io/sensorbio-mcp-server sensorbio-mcp-server

认证

方法 环境变量 最适合
API代币 SENSR_ORG_TOKEN 或 SENSR_API_KEY 大多数用户（推荐）
OAuth2 SENSR_CLIENT_ID + SENSR_CLIENT_SECRET 程序化/高级使用

服务器检查 SENSR_ORG_TOKEN 首先，然后 SENSR_API_KEY 作为一种退路。如果两者都没有设置，它将尝试OAuth2客户端凭据。

OAuth2配置（高级）

{
  "mcpServers": {
    "sensorbio": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/GetSensr-io/sensorbio-mcp-server",
        "sensorbio-mcp-server"
      ],
      "env": {
        "SENSR_CLIENT_ID": "your-client-id",
        "SENSR_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

你可以问什么

一旦连接，您的AI助手就可以访问这些工具：

工具 它做什么 示例问题
list_users 列出组织中的所有用户 “显示所有用户”
get_user_ids 获取所有用户ID “组织中有多少用户？”
get_user_by_email 通过电子邮件地址查找用户 “查找john@example.com"
get_user_profile 获取特定用户的完整个人资料 “显示Bryan的个人资料”
搜索用户 按姓名或电子邮件搜索用户 “查找名为Sarah的用户”
get_sleep 睡眠数据：持续时间、得分、阶段 “我上周睡得怎么样？”
get_scores 恢复、睡眠和活动评分 “我今天的恢复评分是多少？”
获取活动 锻炼和活动课程 “本周我做了哪些锻炼？”
get_biometrics 心率、心率变异性、血氧饱和度、呼吸频率 “我的静息心率是多少？”
get_库存 卡路里燃烧详情 “我今天燃烧了多少卡路里？”
get_arg_sleep\summary 整个组织的睡眠概况 “团队昨晚睡得怎么样？”
get_org_scores_summary 整个组织的得分概览 “显示团队的恢复得分”
debug_request 原始API请求（用于故障排除） 通常不直接需要

大多数工具支持灵活的日期范围。你可以说“过去7天”、“3月1日至3月10日”或“昨天”，人工智能会找出正确的参数。

环境变量

变量 必填 描述
SENSR_ORG_TOKEN * 组织API令牌（推荐）
SENSR_API_KEY * 别名 SENSR_ORG_TOKEN
SENSR_CLIENT_ID ** OAuth2客户端ID
SENSR_CLIENT_SECRET ** OAuth2客户端机密
SENSR_SCOPE OAuth2作用域（可选）
SENSR_BASE_URL 覆盖API基础URL（默认值： https://api.sensorbio.com)
SENSR_TZ “今天”计算的时区（默认值： America/Chicago)

*设置以下之一 SENSR_ORG_TOKEN 或 SENSR_API_KEY 用于令牌身份验证。 **为OAuth2身份验证设置两者。如果两者都已配置，则令牌身份验证优先。

故障排除

“服务器未连接”

  • 确保 uv 已安装：运行 uv --version 在您的终端
  • 检查您的配置文件路径是否正确（见上表）
  • 请确保在编辑配置后重新启动了Claude Desktop

“身份验证错误”或“API密钥无效”

  • 仔细检查你的令牌。从开发人员门户中直接复制它。
  • 确保令牌中没有多余的空格或换行符
  • 令牌可能会过期。如果你的旧了，就生成一个新的。

“没有数据显示”

  • 您的Sensor Bio设备最近需要同步
  • 检查用户ID是否存在于您的组织中
  • 试着问一个具体的日期：“让我在3月10日睡觉”

“找不到工具”

  • 确保配置中的MCP服务器名称准确无误 sensorbio
  • 检查Claude Desktop的MCP工具列表以了解连接状态

发展

您想在本地进行贡献或运营吗？

# Clone the repo
git clone https://github.com/GetSensr-io/sensorbio-mcp-server.git
cd sensorbio-mcp-server

# Install dependencies
uv sync --dev

# Run tests
uv run pytest -v

# Lint
uv run ruff check .

# Run the server locally
SENSR_ORG_TOKEN=your-token uvx --from . sensorbio-mcp-server

# Smoke test (needs a valid token)
SENSR_ORG_TOKEN=your-token uv run python scripts/smoke_test.py

许可证

麻省理工学院

相关 MCP