floriankimmel/runalyze-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

9 stars 8 forks 품질 58 트렌드 17

Repository Install

A secure MCP server that lets you retrieve data from your Runalyze account.

개요

Access your Runalyze health metrics through AI assistants using the Model Context Protocol (MCP) A secure MCP server that lets you retrieve health data (HRV, Sleep, Resting Heart Rate, Activities) from your Runalyze account directly within AI chat applications like Claude Desktop and ChatGPT Desktop. This server can be used in . Choose the option that works best for you: - ✅ Complete privacy - data stays on your machine - ✅ No internet required after setup - ✅ Free to use - ✅ Full control - ⚠️ Requires Node.js installation - ⚠️ Need to build from source - ⚠️ Only works on the computer where it's installed - ✅ No installation required - ✅ Works from any device - ✅ Always up-to-date - ✅ Quick 2-minute setup - ⚠️ Requires internet connection - ⚠️ Depends on hosted service availability Both options are secure. The hosted version does NOT store your API token - you provide it with each request, just like the local version stores it in your config file.

README

원문 README의 일부입니다. 원문 보기.

🏃 Runalyze MCP Server

Access your Runalyze health metrics through AI assistants using the Model Context Protocol (MCP)

A secure MCP server that lets you retrieve health data (HRV, Sleep, Resting Heart Rate, Activities) from your Runalyze account directly within AI chat applications like Claude Desktop and ChatGPT Desktop.

🎯 Choose Your Setup

This server can be used in two ways. Choose the option that works best for you:

Security Note: Both options are secure. The hosted version does NOT store your API token - you provide it with each request, just like the local version stores it in your config file.

📖 Table of Contents

Option 1: Local Setup
Option 2: Hosted Setup
- Configure Your AI Tool
What You Can Do
Troubleshooting

🖥️ Option 1: Local Setup

Run the MCP server on your own computer.

Prerequisites

Before you start, make sure you have:

Node.js v18 or higher (via Devbox or manual install)
Yarn package manager (Installation guide)
A Runalyze account with premium access (Get premium)
An AI assistant that supports MCP (Claude Desktop, ChatGPT Desktop, VS Code extensions, etc.)

Installation

Step 1: Download and Build

# Clone the repository
git clone https://github.com/floriankimmel/runalyze-mcp-server.git
cd runalyze-mcp-server

Option A: Using Devbox (Recommended)

Devbox provides isolated, reproducible dev environments.

Install devbox and direnv:
```
# macOS
brew install devbox direnv
```
Enable direnv in the project:
```
direnv allow
```
Run devbox scripts:

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "runalyze": {
      "command": "node",
      "args": [
        "/absolute/path/to/runalyze-mcp-server/dist/main.js"
      ],
      "env": {
        "RUNALYZE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}