Pulsyn MCP Server

🚀 Pulsyn MCP Server

通過模型上下文協議，你可以直接在AI助手訪問Pulsyn智能戒指的健康數據。

🚀 快速開始

1. 獲取API令牌

1. 打開Pulsyn移動應用。
2. 導航至設置 → API訪問。
3. 點擊**“創建新令牌”**。
4. 選擇read:health_data範圍。
5. 複製令牌（以psk_開頭）。

2. 配置令牌

export PULSYN_API_TOKEN=psk_your_token_here

3. 添加到Claude桌面應用

將以下內容添加到你的Claude桌面應用配置文件中（macOS系統路徑為~/Library/Application Support/Claude/claude_desktop_config.json，Windows系統路徑為%APPDATA%/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "pulsyn": {
      "command": "bunx",
      "args": ["pulsyn-mcp-server"],
      "env": {
        "PULSYN_API_TOKEN": "psk_your_token_here"
      }
    }
  }
}

✨ 主要特性

• 睡眠追蹤：包括睡眠時長、睡眠階段（深度/淺度/快速眼動/清醒）、質量評分和效率。
• 心率變異性分析：測量心率變異性，以瞭解恢復情況和壓力水平。
• 心率監測：持續監測心率並記錄靜息心率。
• 活動數據：記錄步數、卡路里消耗、活躍分鐘數和運動距離。
• 身體狀態評分：結合睡眠、心率變異性和恢復情況給出每日身體狀態評分。
• 健康摘要：提供全面的每日健康快照。

📦 安裝指南

使用bunx（推薦）

無需安裝，直接運行：

bunx pulsyn-mcp-server

使用npm

npm install -g pulsyn-mcp-server
pulsyn-mcp-server

從源代碼安裝

git clone https://github.com/getpulsyn/pulsyn-mcp-server.git
cd pulsyn-mcp-server
bun install
bun run build

📚 詳細文檔

環境變量

配置文件

你也可以創建~/.config/pulsyn-mcp-server/config.json文件：

{
  "apiToken": "psk_your_token_here",
  "baseUrl": "https://www.getpulsyn.com/api/v1",
  "debug": false
}

💻 使用示例

可用工具

get_sleep_data

獲取睡眠記錄，包括睡眠時長、睡眠階段、質量評分和效率。 參數：

• days（數字）：要獲取數據的天數（默認值：7，最大值：90）
• limit（數字）：最大結果數（默認值：100，最大值：1000）

示例提示：

• "顯示我上週的睡眠數據"
• "我昨晚的深度睡眠百分比是多少？"

get_hrv_data

獲取心率變異性測量數據，這是恢復情況和壓力水平的關鍵指標。 參數：

• days（數字）：要獲取數據的天數（默認值：7，最大值：90）
• limit（數字）：最大結果數（默認值：100，最大值：1000）

示例提示：

• "我這個月的平均心率變異性是多少？"
• "顯示我過去一週的心率變異性趨勢"

get_heart_rate_data

獲取連續的心率測量數據，包括靜息心率。 參數：

• days（數字）：要獲取數據的天數（默認值：7，最大值：90）
• limit（數字）：最大結果數（默認值：100，最大值：1000）

get_activity_data

獲取每日活動指標，如步數、卡路里消耗、活躍時間和運動距離。 參數：

• days（數字）：要獲取數據的天數（默認值：7，最大值：90）
• limit（數字）：最大結果數（默認值：100，最大值：1000）

get_readiness_score

獲取結合睡眠、心率變異性和恢復情況的每日身體狀態評分。 參數：

• days（數字）：要獲取數據的天數（默認值：7，最大值：90）
• limit（數字）：最大結果數（默認值：100，最大值：1000）

get_health_summary

獲取特定日期的全面健康摘要。 參數：

• date（字符串）：日期，格式為YYYY - MM - DD（默認值：今天）

🔧 技術細節

速率限制

Pulsyn API根據賬戶等級實施不同的速率限制：

錯誤處理：

• 超過限制時返回429 Too Many Requests錯誤。
• 自動重試，採用指數退避和抖動算法。
• 遵循Retry - After頭信息進行速率限制恢復。

安全措施

• 僅本地存儲：令牌僅存儲在你的設備上。
• 只讀訪問：無法修改你的健康數據。
• 僅使用HTTPS：所有通信均加密。
• 令牌撤銷：可隨時在Pulsyn應用中撤銷令牌。

故障排除

開發

# 以開發模式運行
bun run dev

# 運行測試
bun test

# 類型檢查
bun run typecheck

# 代碼檢查
bun run lint

# 生產構建
bun run build

貢獻代碼

請參閱CONTRIBUTING.md瞭解貢獻指南。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

🔗 相關鏈接

• Pulsyn官網
• API文檔
• 模型上下文協議
• GitHub倉庫