HRT PK MCP

Hormone Replacement Therapy (HRT) pharmacokinetic blood concentration monitoring MCP tool

Agents can record dosing times through tools and query fitted blood concentrations based on PK algorithms at any time

References the algorithm and data fitting implementation of HRT-Recorder-PKcomponent-Test

Supports multiple administration routes for Estradiol and Testosterone

Quick Start

git clone https://github.com/lfcypo/hrt-pk-mcp
uv sync

uv run hrt-pk-mcp
# 或
python -m pk_mcp

Related MCP server: CaffeineCurfew

MCP Tools

log_dose - Record a dose event

Records a hormone medication event. Each event is persisted and included in the calculation of all subsequent concentration queries.

query_concentration - Query predicted blood concentration at a specified time point

Data Storage

Dose events are persisted in JSON format in the .hrt-pk-data/dose_events.json file in the project directory

Can be inspected, backed up, or migrated across sessions

Pharmacokinetic Algorithm

The pharmacokinetic algorithm and constants in this project reference HRT-Recorder-PKcomponent-Test

For detailed PK algorithms, complete parameter derivation, calibration sources, etc., please refer to HRT-Recorder and pk_research

Supported Compounds and Administration Routes

Estradiol

Testosterone

Output Units

• Estradiol pg/mL pmol/L

• Testosterone ng/dL ng/mL nmol/L

Cross-validation of Migration

This project has undergone simulated data cross-validation experiments; the results of this project are numerically consistent with the source project's results

python ./test/cross_validate.py

License

This project complies with the MIT License

Acknowledgments

• PK algorithm and constants, algorithm application LaoZhong-Mihari/HRT-Recorder-PKcomponent-Test

• PK algorithm and constants TransmtfTeam/Transmtf-HRT-Tracker

• Algorithm application mkx173/Featherline

• Algorithm application xunxunProjects/Oyama-s-HRT-Tracker

Correction Contact

If you have any questions or suggestions about the pharmacokinetic algorithm part of the project, please file an issue or contact the academic correspondence email research@lfcypo.com

Serious Warning

This project is developed for educational purposes and is only recommended for pharmacokinetic model research, algorithm validation, and data analysis

The blood concentration results output by this project are derived from mathematical model fitting and theoretical parameter calculations, and are not equivalent to real individual blood concentration test results, nor can they replace clinical laboratory testing, pharmacokinetic research, or professional medical evaluation

Not recommended for any clinical medical use, including but not limited to:

• Guiding users to start, stop, adjust, or change hormone treatment plans;

• Determining doses of estradiol, testosterone, or other sex hormone medications;

• Judging whether drug treatment is safe, effective, or achieves treatment goals;

• Replacing doctors in prescribing, diagnosis, or medical decision-making;