Huppa MCP

🏋️‍♀️ Huppa命令行界面

CLI工具和 主控程序 服务器 赫帕 --浏览体育课程，预订课程，并通过命令行或Claude等人工智能助手管理预订。

免责声明： 这是一个非官方的社区建设项目 不隶属于、不受Huppa认可或不被Huppa批准.它使用您的个人凭据与Huppa的公共API交互。使用风险自负——作者不对任何帐户限制、数据丢失或其他后果负责。Huppa可能随时更改其API，这可能会在没有通知的情况下破坏此工具。

⚙️ 安装

先决条件： Python 3.11+， 诗歌

git clone https://github.com/maxzw/huppa-cli.git
cd huppa-cli
poetry install

# Run one-time interactive setup (stores credentials in OS keychain)
poetry run huppa auth setup

🔑 认证

setup命令会提示输入电子邮件/密码/子域，并将其安全地存储在您的系统密钥链中。

要查找您的子域，请打开您的Huppa健身房页面URL，并使用前面的第一部分 .huppa.app.

例子： https://mygym.huppa.app/me → 子域是 mygym

poetry run huppa auth setup   # interactive credential setup
poetry run huppa auth whoami  # show current authenticated user
poetry run huppa auth logout  # clear stored credentials

特定于配置文件的身份验证：

HUPPA_PROFILE=work-gym poetry run huppa auth setup
HUPPA_PROFILE=work-gym poetry run huppa auth whoami

环境变量身份验证：

HUPPA_EMAIL="you@example.com" \
HUPPA_PASSWORD="your-password" \
HUPPA_SUBDOMAIN="mygym" \
poetry run huppa classes 2026-03-08

🛠️ CLI使用情况

所有命令都输出结构化JSON。

# List classes for a date
huppa classes 2026-03-08

# List classes for multiple dates
huppa classes 2026-03-08 2026-03-09

# Show upcoming bookings
huppa bookings
huppa bookings --filter past --per-page 10

# Show memberships
huppa memberships

# Book a class (use organization_id and occurrence_id from `huppa classes`)
huppa book  

# Cancel a booking
huppa cancel  

# Waitlist management
huppa waitlist join  
huppa waitlist leave  

# Show all available commands
huppa --help

🤖 MCP服务器

CLI包括一个用于AI助手的内置MCP服务器：

huppa mcp

连接到克劳德桌面

将以下内容添加到您的Claude Desktop配置文件中(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "huppa": {
      "command": "/path/to/bin/huppa",
      "args": ["mcp"]
    }
  }
}

替换 /path/to/bin/huppa 与您的完整路径 huppa 可执行文件(which huppa).

诗歌模式：

{
  "mcpServers": {
    "huppa": {
      "command": "/full/path/to/poetry",
      "args": ["--directory", "/absolute/path/to/huppa-cli", "run", "huppa", "mcp"]
    }
  }
}

如果您使用诗歌模式，请选择完整路径 poetry 而不是 "poetry" 因为Claude Desktop可能会在有限的时间内启动MCP服务器 PATH.

MCP工具

📋 许可证

麻省理工学院