Workout Maker

Provides an MCP server to generate exercise pages, sessions, and multi-day workout plans with optional visual prompts integration.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "idjohnson-workoutmakermcp": {
      "command": "python",
      "args": [
        "workout_server.py"
      ]
    }
  }
}

You are running an MCP server designed to help you create workout content, organize sessions, and generate balanced multi-day plans. Use it to produce exercise pages, group exercises into sessions, and assemble comprehensive plans tailored to goals and age. This server exposes practical tools that let you generate Markdown exercise pages and plan schedules, while integrating visual prompts for illustrations.

How to use

You interact with the Workout Maker MCP Server using an MCP client. Start the local server and then use the available tools to generate content. The server is designed to help you create detailed exercise pages, compose balanced sessions, and assemble multi-day workout plans. You can later render exercise pages in Markdown and generate image prompts for illustrations using the integrated Gemini/NanoBanana workflow.

Typical usage patterns include creating an exercise page, forming a daily session that groups exercises by movement pattern, and producing a full multi-day plan that balances Push, Pull, Legs, and Core movements. Each tool returns structured outputs that you can save or publish as part of your workout content library.

How to install

Prerequisites you need on your machine before starting the server are Python and pip, plus access to a terminal or command prompt.

pip install -r requirements.txt

Next, run the server using Python with the main script.

python workout_server.py

Notes and typical flow

The server exposes three core tools you will use to generate content. Each tool is designed to be called with clear parameters and returns results you can store or publish as Markdown content.

Troubleshooting

If the server fails to start, verify that Python and the required packages from requirements.txt are installed. Check for missing dependencies or permission issues on the host machine. If you encounter configuration errors, double-check that the run command matches the instructions above and that you are running from the project directory that contains workout_server.py and requirements.txt.

Integration with Gemini/NanoBanana

When you create an exercise page, the tool outputs a Markdown block that includes an image prompt. This is designed to work with the Gemini CLI extensions to generate consistent illustrations for your workout content.

Available tools

create_exercise_page

Generates a detailed exercise page in Markdown with step-by-step instructions and image prompts for visual content.

create_session

Groups exercises into a balanced daily workout, organizing movements into Push, Pull, Legs, and Core.

create_workout_plan

Produces a multi-day workout plan tailored to goals and age, ensuring balanced movement patterns.