Skip to main content

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.

Metadata

Release files for mcp-server-bmi-calculator 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-server-bmi-calculator 0.2.2
File Size Uploaded
mcp_server_bmi_calculator-0.2.2.tar.gz 3.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-server-bmi-calculator 0.2.2
File Interpreter ABI Platform
mcp_server_bmi_calculator-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 8.0 kB

Release files / mcp_server_bmi_calculator-0.2.2.tar.gz

Download URL mcp_server_bmi_calculator-0.2.2.tar.gz
Size 3.6 kB
Tags Source
SHA-256 checksum
How to use checksums
3d09bd022ac22d9204f2fc92c76d0410a34cb631d70b6b353e38d878b29ae143
BLAKE2b-256 checksum
How to use checksums
d87999b3b85f6d96ac3108f974a348d22099912812a04713955eaf394a6a87ec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release files / mcp_server_bmi_calculator-0.2.2-py3-none-any.whl

Download URL mcp_server_bmi_calculator-0.2.2-py3-none-any.whl
Size 4.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0feecb5d56a2ed70fb97a2d40261b4025961c955f2f5d19ef4ee083b5a77817e
BLAKE2b-256 checksum
How to use checksums
df00e2803f8e9ddd13f04ead91fe3fd8221f877f65baa20e37a1d60cc56baa68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page