AI导哈

健身数据查询服务

一个提供访问Hevy健身应用数据的模型上下文协议（MCP）服务器，支持通过自然语言查询健身历史记录。

  • by swrm-io
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 swrm-io/hevy-mcp

使用说明

Hewy MCP服务器

模型上下文协议（MCP）服务器，提供对以下锻炼数据的访问 Hevy，一款流行的举重和锻炼跟踪应用程序。

概述

此MCP服务器允许像Claude这样的人工智能助手从您的Hevy帐户中查询和检索锻炼数据，从而与您的健身历史进行自然语言交互。

特性

工具

  • get_workout_count：获取您Hevy帐户中的锻炼总数
  • get_workouts：使用分页支持从最新到最旧检索您的训练
    • 默认限制：5次训练
    • 最大限制：每次请求10次锻炼
    • 支持分页偏移

先决条件

  • 拥有API访问权限的Hevy帐户
  • Hevy API密钥

安装

选项1：下载预构建二进制文件（推荐）

从以下网址下载适用于您平台的最新版本 发布页面:

  • Linux: hevy-mcp_Linux_x86_64.tar.gz
  • macOS（英特尔）: hevy-mcp_Darwin_x86_64.tar.gz
  • macOS（苹果硅）: hevy-mcp_Darwin_arm64.tar.gz
  • 视窗: hevy-mcp_Windows_x86_64.zip

提取存档，即可使用 hevy-mcp 二元的。

选项2：从源代码构建

要求：转到1.25.1或更高版本

  1. 克隆存储库：
git clone https://github.com/swrm-io/hevy-mcp.git
cd hevy-mcp
  1. 构建服务器：
go build -o hevy-mcp

配置

环境变量

  • HEVY_API_KEY （必需）：您的Hevy API密钥

使用Claude Desktop进行设置

将此配置添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "/path/to/hevy-mcp",
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

用法

运行服务器

export HEVY_API_KEY="your-api-key-here"
./hevy-mcp

示例查询（通过Claude）

一旦配置了Claude Desktop，您可以提出以下问题：

  • “我在Hevy有多少次锻炼？”
  • “显示我最近5次锻炼”
  • “我在最近的锻炼中做了什么锻炼？”

发展

服务器是使用以下方式构建的：

项目结构

  • main.go -服务器初始化和工具注册
  • types.go -请求和服务的类型定义
  • workouts.go -与锻炼相关的工具实施

许可证

有关详细信息，请参阅LICENSE文件。

贡献

欢迎投稿！请随时提交拉取请求。

相关 MCP