floriankimmel/runalyze-mcp-server

开发工具

本页由 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 新手？先看 mcpskill.org 教程 →

配置

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