Skip to main content

A Model Context Protocol server for BMI (Body Mass Index) calculation and health assessment

Project description

BMI Calculator MCP Server

A Model Context Protocol server for calculating BMI (Body Mass Index) and providing health status assessments.

Features

  • BMI calculation based on height and weight
  • Health status assessment according to WHO standards
  • Support for metric units (meters and kilograms)

Installation

Using uvx (recommended)

uvx mcp-server-bmi-calculator@latest

Using pip

pip install mcp-server-bmi-calculator

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "bmi-calculator": {
      "command": "uvx",
      "args": ["mcp-server-bmi-calculator@latest"]
    }
  }
}

With Cline

Add to your MCP settings:

{
  "mcpServers": {
    "bmi-calculator": {
      "command": "uvx",
      "args": ["mcp-server-bmi-calculator@latest"]
    }
  }
}

Available Tools

calculate_bmi

Calculate Body Mass Index (BMI) and return health status assessment.

Parameters:

  • height (number, required): Height in meters (e.g., 1.75)
  • weight (number, required): Weight in kilograms (e.g., 70)

Returns:

  • bmi: Calculated BMI value (rounded to 1 decimal place)
  • category: Health category (underweight/normal/overweight/obese)
  • health_status: Chinese description of health status

Health Status Categories:

  • BMI < 18.5: Underweight (体重过轻)
  • 18.5 ≤ BMI < 24: Normal weight (体重正常)
  • 24 ≤ BMI < 28: Overweight (超重)
  • BMI ≥ 28: Obese (肥胖)

Example:

Input:

{
  "height": 1.75,
  "weight": 70
}

Output:

{
  "bmi": 22.9,
  "category": "normal",
  "health_status": "体重正常"
}

Development

Setup

# Clone the repository
git clone https://github.com/yourusername/mcp-server-bmi-calculator
cd mcp-server-bmi-calculator

# Install dependencies
pip install -e .

Running locally

python -m mcp_server_bmi_calculator

Building

python -m build

License

MIT License - see LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_bmi_calculator-0.2.0.tar.gz (3.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_bmi_calculator-0.2.0-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_bmi_calculator-0.2.0.tar.gz.

File metadata

File hashes

Hashes for mcp_server_bmi_calculator-0.2.0.tar.gz
Algorithm Hash digest
SHA256 d8fcf12f37526105fa6bfb252827ab352d995738ee407b5fd6b3444582a66bce
MD5 4d135b739dfec2d936a306eb2d9c8741
BLAKE2b-256 5eca8e1ff610e343d2a0f28a7ff61931fb8bc8050910a408ed5a1430c821f1a2

See more details on using hashes here.

File details

Details for the file mcp_server_bmi_calculator-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_bmi_calculator-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f1ebc144e764d24a1397d006b77f78b0e5f0692205b3dd050b7cae2956127261
MD5 89092dfb104ce7b57a086bd43cb8b2cb
BLAKE2b-256 f67f67e8dead4e9bf96854fa260070a7f4fbe8bef8d909817d0a53fadd09c985

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page