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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_server_bmi_calculator-0.2.2.tar.gz.
File metadata
- Download URL: mcp_server_bmi_calculator-0.2.2.tar.gz
- Upload date:
- Size: 3.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3d09bd022ac22d9204f2fc92c76d0410a34cb631d70b6b353e38d878b29ae143
|
|
| MD5 |
e9781d32819318a0c614451758266ec5
|
|
| BLAKE2b-256 |
d87999b3b85f6d96ac3108f974a348d22099912812a04713955eaf394a6a87ec
|
File details
Details for the file mcp_server_bmi_calculator-0.2.2-py3-none-any.whl.
File metadata
- Download URL: mcp_server_bmi_calculator-0.2.2-py3-none-any.whl
- Upload date:
- Size: 4.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0feecb5d56a2ed70fb97a2d40261b4025961c955f2f5d19ef4ee083b5a77817e
|
|
| MD5 |
8eda502bef0b6348aaa8e6f498d1945e
|
|
| BLAKE2b-256 |
df00e2803f8e9ddd13f04ead91fe3fd8221f877f65baa20e37a1d60cc56baa68
|