HRT-PK-MCP
Enables recording hormone dosing events and querying predicted blood concentration for estradiol and testosterone using pharmacokinetic algorithms, supporting multiple administration routes.
README
HRT PK MCP
激素替代治疗 (HRT) 药代动力学血药浓度监测 MCP 工具
Agent 可通过工具记录给药时间，并随时查询根据 PK 算法拟合的血药浓度
参考 HRT-Recorder-PKcomponent-Test 算法与数据拟合实现
支持雌二醇 (Estradiol) 和睾酮 (Testosterone) 的多种给药途径
快速开始
git clone https://github.com/lfcypo/hrt-pk-mcp
uv sync
uv run hrt-pk-mcp
# 或
python -m pk_mcp
MCP 工具
| 工具 | 说明 |
|---|---|
log_dose |
记录一次给药事件 |
query_concentration |
查询指定时间点的预测血药浓度 |
list_dose_events |
列出所有已记录的给药事件 |
remove_event |
按 ID 删除指定事件 |
clear_all_events |
清空所有给药事件 |
log_dose 记录一次给药事件
记录一次激素用药事件。每个事件会被持久化存储，并在后续所有浓度查询中纳入计算。
| 参数 | 类型 | 说明 |
|---|---|---|
compound |
str | 药物化合物：E2, EB, EV, EC, EN, T, TC, TE, TU |
route |
str | 给药途径：injection, gel, patch_apply, patch_remove, oral, sublingual |
time_h |
float | 给药时间 (距参考起点的小时数) |
dose_mg |
float | 剂量（活性激素当量, 毫克） |
release_rate_ug_per_day |
float? | 贴片零阶释放速率（µg/d），仅 patch_apply 使用 |
area_cm2 |
float? | 凝胶涂抹面积（cm²），仅 gel 使用 |
sublingual_theta |
float? | 舌下含服中经黏膜快通路吸收比例 [0-1]，仅 sublingual 使用 |
query_concentration 查询指定时间点的预测血药浓度
| 参数 | 类型 | 说明 |
|---|---|---|
time_h |
float | 查询时间点（距参考起点的小时数） |
hormone |
str | 目标激素：estradiol 或 testosterone |
body_weight_kg |
float | 体重（kg，默认 70.0；影响分布体积 Vd） |
数据存储
给药事件以 JSON 格式持久化存储在项目目录下的 .hrt-pk-data/dose_events.json 文件中
可跨会话检查、备份或迁移
药代动力学算法
本项目药代动力学算法与常数参考自 HRT-Recorder-PKcomponent-Test
关于详细的PK算法、完整参数推导、校准来源等，请参阅 HRT-Recorder 与 pk_research
支持的化合物与给药途径
雌二醇 (Estradiol)
| 化合物 | 注射 | 口服 | 舌下 | 凝胶 | 贴片 |
|---|---|---|---|---|---|
| E2（雌二醇） | — | ✓ | ✓ | ✓ | ✓ |
| EB（苯甲酸酯） | ✓ | — | — | — | — |
| EV（戊酸酯） | ✓ | ✓ | ✓ | — | — |
| EC（环丙酸酯） | ✓ | — | — | — | — |
| EN（庚酸酯） | ✓ | — | — | — | — |
睾酮 (Testosterone)
| 化合物 | 注射 | 口服 | 凝胶 | 贴片 |
|---|---|---|---|---|
| T（睾酮） | — | — | ✓ | ✓ |
| TC（环丙酸酯） | ✓ | — | — | — |
| TE（庚酸酯） | ✓ | — | — | — |
| TU（十一酸酯） | ✓ | ✓ | — | — |
输出单位
- 雌二醇 pg/mL pmol/L
- 睾酮 ng/dL ng/mL nmol/L
迁移的交叉验证
本项目已进行模拟数据交叉验证实验，本项目运行结果与源项目运行结果数值上一致
python ./test/cross_validate.py
许可
本项目遵守 MIT License
致谢
- PK算法及常数、算法应用 LaoZhong-Mihari/HRT-Recorder-PKcomponent-Test
- PK算法及常数 TransmtfTeam/Transmtf-HRT-Tracker
- 算法应用 mkx173/Featherline
- 算法应用 xunxunProjects/Oyama-s-HRT-Tracker
修正联系
若对项目中的药代动力学算法部分有任何问题或建议，请提出 issue 或联系学术通讯邮箱 lfcypo@gmail.com
严重警告
本项目以教育目的开发，仅建议用于药代动力学模型研究、算法验证、数据分析方面
本项目输出的血药浓度结果来自数学模型拟合与理论参数计算，不等同于真实个体的血药浓度检测结果，不能替代临床实验室检测、药代动力学研究或医学专业评估
不建议将本项目用于任何临床医学用途，包括但不限于：
- 指导使用者开始、停止、调整或改变激素治疗方案；
- 决定雌二醇、睾酮或其他性激素药物的剂量；
- 判断药物治疗是否安全、有效或达到治疗目标；
- 替代医生进行处方、诊疗或医学决策；
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.