juxsta/wger-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

5 stars 5 forks Качество 69 Тренд 13MIT

Model Context Protocol (MCP) server for the wger fitness API - enables AI assistants to access workout, exercise, and nutrition data

Обзор

A production-ready Model Context Protocol (MCP) server that provides AI assistants like Claude with seamless access to the wger fitness API. Search through 400+ exercises, create workout routines, and manage fitness data - all through natural conversation. The wger MCP server enables AI assistants to integrate with wger, a free, open-source fitness and workout management platform. With this MCP server, Claude Desktop and other AI applications can: - Search and discover exercises by muscle group, equipment, or keywords - Retrieve detailed exercise information including form instructions - Create and manage workout routines for authenticated users - Add exercises to routines with customizable sets, reps, and weights This server implements the Model Context Protocol, making it compatible with any MCP-enabled AI application.

README

Показан фрагмент оригинального README. Открыть оригинал.

wger MCP Server

Overview

The wger MCP server enables AI assistants to integrate with wger, a free, open-source fitness and workout management platform. With this MCP server, Claude Desktop and other AI applications can:

Search and discover exercises by muscle group, equipment, or keywords
Retrieve detailed exercise information including form instructions
Create and manage workout routines for authenticated users
Add exercises to routines with customizable sets, reps, and weights

This server implements the Model Context Protocol, making it compatible with any MCP-enabled AI application.

Key Features

12 Powerful Tools: Comprehensive exercise discovery and workout management capabilities
Type-Safe: Built with TypeScript in strict mode with full type definitions
Intelligent Caching: Automatic caching of static data to minimize API calls
Robust Authentication: JWT-based auth with automatic token refresh
Error Handling: User-friendly error messages with graceful fallbacks
High Test Coverage: 80%+ code coverage with unit and integration tests
Production Ready: Comprehensive logging, retry logic, and timeout handling
Zero Cost: Access to 400+ exercises from the free wger API

Quick Start

Prerequisites

Node.js 18.0.0 or higher
Claude Desktop (or another MCP-compatible application)
wger Account (optional, only needed for workout management features)

Installation

Option 1: Using Claude Code CLI (Recommended)

claude mcp add wger -e WGER_API_KEY=your_key_here -- npx -y @juxsta/[email protected]

Option 2: Install globally via npm

npm install -g @juxsta/wger-mcp
claude mcp add wger -e WGER_API_KEY=your_key_here -- wger-mcp

Option 3: For development, clone and build locally

git clone https://github.com/Juxsta/wger-mcp.git
cd wger-mcp
npm install
npm run build

Basic Configuration

Get your wger API credentials (optional for read-only features):
- Visit wger.de and create an account
- Generate an API key from your account settings
- Or use your username and password
Configure Claude Desktop:

Open your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Открыть полный README на GitHub

Установка

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

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
     "mcpServers": {
       "wger": {
         "command": "node",
         "args": ["/absolute/path/to/wger-mcp/dist/index.js"],
         "env": {
           "WGER_API_KEY": "your_api_key_here"
         }
       }
     }
   }