Open MedKit 

家里药箱总是乱糟糟？找不到药、忘了过期、不知道有没有库存？Open MedKit 是一款家庭药箱管理工具，它抛弃了繁琐的表单录入，让你只需说一句话，AI 就能自动完成药品入库、分类、有效期追踪和过期提醒。

更强大的是，它原生支持 MCP (Model Context Protocol)，你可以直接在 Claude Code、Cursor、OpenClaw 等 AI 编程助手的终端里，用自然语言管理药箱：“帮我加个布洛芬”、“查查有没有快过期的感冒药”，一切尽在掌控。

核心亮点：极简交互，智能内核

1. 自然语言录入 (Say to Add)

• 告别表单：不需要手动选择分类、填写规格、计算日期。
• 智能解析：只需输入“两盒布洛芬缓释胶囊，2025 年 12 月过期”或拍照识别（需配合 OCR），AI 自动提取药品名称、规格、数量、有效期、生产厂家等所有字段。
• 批量处理：首次整理药箱？直接将整张购物小票或手写清单复制粘贴（换行分隔），AI 一键批量解析入库。

2. 对话式检索 (Chat to Find)

• 像聊天一样找药：
  • “家里有退烧药吗？”
  • “快过期的药有哪些？”
  • “上次买的阿莫西林还有多少？”
• AI 理解语义，直接给出精准答案，无需手动筛选。

3. 智能过期预警

• 自动标记：到期或即将过期的药品自动高亮显示。
• 主动推送：支持集成 Telegram Bot，每日推送过期提醒，再也不怕误服过期药。

4. MCP Agent 原生接入 (开发者/极客最爱)

• 终端即药箱：内置 MCP Server，无需打开网页。
• 无缝集成：在 Claude Code、Cursor、Claude Desktop、OpenClaw 中直接调用 add_medication 或 search_medications 工具。
  • 场景：你在写代码时突然想到药箱空了，直接在终端对 AI 说：“帮我在 Open MedKit 里记一下，需要买维生素 C”，任务即刻完成。

5. 隐私优先 & 灵活部署

• 本地存储：数据默认保存在本地 SQLite 数据库，绝不上传云端。
• 兼容任意 AI：支持任何兼容 OpenAI /v1/chat/completions 接口的模型（OpenAI, DeepSeek, Ollama, LocalAI 等）。
• 一键部署：基于 Docker，一行命令启动。

快速开始 (Quick Start)

只需几分钟，即可拥有专属的智能药箱。

第一步：克隆项目

git clone https://github.com/MonoYan/open-medkit.git
cd open-medkit

第二步：配置环境变量

复制示例配置文件并编辑：

cp .env.example .env

在 .env 文件中至少设置你的 AI API Key：

AI_API_KEY=sk-your-api-key-here
# 可选：自定义 API 地址 (如使用 Ollama 或 DeepSeek)
AI_BASE_URL=https://api.deepseek.com/v1
# 可选：Telegram Bot Token (用于推送提醒)
TELEGRAM_BOT_TOKEN=...

第三步：启动服务

docker compose up -d

第四步：开始使用

• Web 界面：访问 http://localhost:3000，开始语音/文字录入。
• MCP 集成：在你的 AI 客户端配置中添加 Open MedKit 的 MCP Server 地址，即可在对话中直接调用。

典型使用场景