English Français العربية

MusclesWorked

السجل الرسمي أخرى

Exercise-to-muscle mapping: 856 exercises, 65 muscles, workout analysis & alternatives.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package musclesworked-mcp
Claude Code 
claude mcp add musclesworked -e 'MUSCLESWORKED_API_KEY=<your musclesworked_api_key>' -- npx -y musclesworked-mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "musclesworked": {
            "command": "npx",
            "args": [
                "-y",
                "musclesworked-mcp@0.1.0"
            ],
            "env": {
                "MUSCLESWORKED_API_KEY": "<your musclesworked_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • MUSCLESWORKED_API_KEY إلزامي سري Your MusclesWorked API key (get one at musclesworked.com/dashboard)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. musclesworked-mcp
  2. Setup
  3. Tools
  4. Example Prompts
  5. Configuration
  6. Development
  7. License

musclesworked-mcp

MCP server for the musclesworked.com exercise-to-muscle mapping API.

Connects Claude Desktop, Claude Code, Cursor, and other MCP clients to 856 exercises and 65 muscles with detailed primary/secondary/stabilizer activation data across 14 muscle groups.

Setup

Get an API key at musclesworked.com/dashboard.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "musclesworked": {
      "command": "npx",
      "args": ["-y", "musclesworked-mcp"],
      "env": {
        "MUSCLESWORKED_API_KEY": "mw_live_..."
      }
    }
  }
}
Claude Code
claude mcp add musclesworked -- npx -y musclesworked-mcp --api-key mw_live_...

Or add to .mcp.json:

{
  "mcpServers": {
    "musclesworked": {
      "command": "npx",
      "args": ["-y", "musclesworked-mcp", "--api-key", "mw_live_..."]
    }
  }
}
Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "musclesworked": {
      "command": "npx",
      "args": ["-y", "musclesworked-mcp"],
      "env": {
        "MUSCLESWORKED_API_KEY": "mw_live_..."
      }
    }
  }
}

Tools

ToolDescription
get_muscles_workedGet primary, secondary, and stabilizer muscles for an exercise
find_exercisesFind exercises targeting a specific muscle with optional filters
analyze_workoutAnalyze a workout for coverage, gaps, and imbalances
get_alternativesFind alternative exercises ranked by muscle overlap
search_exercisesSearch exercises by name to discover IDs
search_musclesSearch muscles by name to discover IDs

Example Prompts

  • "What muscles does the barbell bench press work?"
  • "Find bodyweight exercises for my chest"
  • "Analyze my push day: bench press, overhead press, tricep pushdown, lateral raise"
  • "What are some alternatives to barbell squats?"
  • "Search for exercises that target the hamstrings"

Configuration

OptionDescription
--api-key <key>API key (or set MUSCLESWORKED_API_KEY env var)
MUSCLESWORKED_API_URLOverride base URL (default: https://musclesworked.com)

Development

git clone https://github.com/csjoblom/musclesworked-mcp.git
cd musclesworked-mcp
npm install
npm run build

# Test with MCP Inspector
MUSCLESWORKED_API_KEY=mw_live_... npx @modelcontextprotocol/inspector node dist/index.js

License

MIT

الأسئلة الشائعة

ما هو MusclesWorked؟

Exercise-to-muscle mapping: 856 exercises, 65 muscles, workout analysis & alternatives.

كيف أثبّت MusclesWorked؟

يعمل على جهازك. في Claude Code: claude mcp add musclesworked -e 'MUSCLESWORKED_API_KEY=<your musclesworked_api_key>' -- npx -y musclesworked-mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج MusclesWorked إلى مفتاح API؟

نعم. يتطلب MUSCLESWORKED_API_KEY، وتضبطها في إعداداته.

هل MusclesWorked مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون MusclesWorked؟

ينشره csjoblom. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.