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配置文件：

添加（或合并到） 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

______________________________________________________________________

认证

服务器检查 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助手就可以访问这些工具：

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

______________________________________________________________________

环境变量

\*设置以下之一 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

______________________________________________________________________

许可证

麻省理工学院