运动数据API服务

通过MCP服务器访问Api Ninjas提供的运动数据API,支持按名称、类型、肌肉群等参数筛选运动信息。

  • by BACH-AI-Tools
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 BACH-AI-Tools/exercises_by_api_ninjas

使用说明

Exercises By Api Ninjas MCP Server

English |Simplified Chinese| Traditional Chinese

MCP server used to access the Exercises By API Ninjas API.

🚀 Quickly experience using the EMCP platform

EMCP It is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!

Quick Start:

  1. 🌐 visit EMCP platform
  2. 📝 Register and log in to your account
  3. 🎯 enter MCP SquareBrowse all available MCP servers
  4. 🔍 Search or find this server(bach-exercises_by_api_ninjas)
  5. 🎉 click Install MCP button
  6. ✅ Done! Can be used in your application

Advantages of the EMCP platform:

  • ✨ Zero configurationNo need to manually edit configuration files
  • 🎨 Visual managementEasily manage all MCP servers through a graphical interface
  • 🔐 safe and reliableUnified management of API keys and authentication information
  • 🚀 One-click installationMCP Square offers a wide range of server options
  • 📊 Use statisticsReal time viewing of service invocation status

Visit Now EMCP platform Start your MCP journey!


Introduction

This is an MCP server used to access the Exercises By Api Ninjas API.

  • PyPI package name: bach-exercises_by_api_ninjas
  • version: 1.0.0
  • transmission protocol: stdio

install

Install from PyPI:

pip install bach-exercises_by_api_ninjas

Install from source code:

pip install -e .

run

Method 1: Use UVX (recommended, no installation required)

# 运行(uvx 会自动安装并运行)
uvx --from bach-exercises_by_api_ninjas bach_exercises_by_api_ninjas

# 或指定版本
uvx --from bach-exercises_by_api_ninjas@latest bach_exercises_by_api_ninjas

Method 2: Direct Run (Development Mode)

python server.py

Method 3: Run as a command after installation

# 安装
pip install bach-exercises_by_api_ninjas

# 运行(命令名使用下划线)
bach_exercises_by_api_ninjas

configuration

API certification

This API requires authentication. Please set environment variables:

export API_KEY="your_api_key_here"

environment variable

Variable Name Description Required
API_KEY API Key Yes
PORT Not applicable No
HOST Not applicable No

Use in cursor

Edit cursor MCP configuration file ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bach-exercises_by_api_ninjas": {
      "command": "uvx",
      "args": ["--from", "bach-exercises_by_api_ninjas", "bach_exercises_by_api_ninjas"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Using Claude Desktop

Edit Claude Desktop configuration file claude_desktop_config.json:

{
  "mcpServers": {
    "bach-exercises_by_api_ninjas": {
      "command": "uvx",
      "args": ["--from", "bach-exercises_by_api_ninjas", "bach_exercises_by_api_ninjas"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

This server provides the following tools:

v1exercises

API Ninjas Exercises API endpoint. Returns up to 10 exercises that satisfy the given parameters.

endpoint: GET /v1/exercises

parameter:

  • name (string): name of exercise. This value can be partial (e.g. press will match Dumbbell Bench Press)

  • type (string): exercise type. Possible values are: cardio olympic_weightlifting plyometrics powerlifting strength stretching strongman

  • muscle (string): muscle group targeted by the exercise. Possible values are: abdominals abductors adductors biceps calves chest forearms glutes hamstrings lats lower_back middle_back neck quadriceps traps triceps

  • difficulty (string): difficulty level of the exercise. Possible values are: beginner intermediate expert

  • offset (number): number of results to offset for pagination. Default is 0.


tech stack

  • transmission protocol: stdio
  • HTTP client: httpx

license

MIT License - see details LICENSE Document.

development

This server is composed of API-to-MCP Tool generation.

Version: 1.0.0