Pulsyn MCP Server

🚀 Pulsyn MCP Server

Model Context Protocol を介して、AIアシスタント内で直接Pulsynスマートリングの健康データにアクセスできます。これにより、睡眠、心拍数、活動量などの健康情報をAIと連携して活用できます。

✨ 主な機能

• 睡眠トラッキング - 睡眠時間、睡眠段階（深い睡眠/浅い睡眠/レム睡眠/目覚め）、睡眠品質スコア、睡眠効率を追跡します。
• HRV分析 - 回復状態やストレスを把握するための心拍変動（HRV）測定を行います。
• 心拍数 - 継続的な心拍数のモニタリングと安静時心拍数を提供します。
• 活動量データ - 歩数、消費カロリー、活動時間、移動距離などの活動量データを記録します。
• レディネススコア - 睡眠、HRV、回復状態を総合した毎日のレディネススコアを算出します。
• 健康要約 - 包括的な毎日の健康情報のスナップショットを提供します。

🚀 クイックスタート

1. APIトークンの取得

1. Pulsynモバイルアプリを開きます。
2. 設定 → APIアクセスに移動します。
3. 「新しいトークンを作成」 をタップします。
4. read:health_data スコープを選択します。
5. トークン（psk_ で始まる）をコピーします。

2. トークンの設定

export PULSYN_API_TOKEN=psk_your_token_here

3. Claude Desktopへの追加

Claude Desktopの設定ファイル（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

回復状態やストレスの重要な指標である心拍変動（HRV）の測定データを取得します。 パラメータ:

• days (数値): 取得する日数（デフォルト: 7、最大: 90）
• limit (数値): 最大結果数（デフォルト: 100、最大: 1000） 例のプロンプト:
• "今月の平均HRVはいくら？"
• "先週のHRVのトレンドを見せて"

get_heart_rate_data

安静時心拍数を含む継続的な心拍数の測定データを取得します。 パラメータ:

• days (数値): 取得する日数（デフォルト: 7、最大: 90）
• limit (数値): 最大結果数（デフォルト: 100、最大: 1000）

get_activity_data

歩数、消費カロリー、活動時間、移動距離などの毎日の活動量メトリクスを取得します。 パラメータ:

• days (数値): 取得する日数（デフォルト: 7、最大: 90）
• limit (数値): 最大結果数（デフォルト: 100、最大: 1000）

get_readiness_score

睡眠、HRV、回復状態を総合した毎日のレディネススコアを取得します。 パラメータ:

• 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ドキュメント
• Model Context Protocol
• GitHubリポジトリ