English | 中文

Open MedKit

对着药箱说句话，剩下的交给 AI。

家庭药箱管理工具 — 自然语言录入 · AI 结构化解析 · 过期自动提醒 · MCP Agent 接入

为什么选择 Open MedKit

家里的药总是找不到、忘了过期、想不起来有没有。

Open MedKit 让你用一句话把药品录入药箱，用一句话从药箱里找药。没有复杂的表单，没有手动归类 —— AI 搞定一切，你只管说。

不想打开浏览器？Open MedKit 同时提供 MCP Server，可以直接在 Claude Code、Cursor、Claude Desktop、OpenClaw 等 AI 客户端中通过自然语言管理药箱 —— 在终端里说一句「帮我加个布洛芬」，药品就入库了。

功能亮点

功能演示

技术栈

快速开始

Docker（推荐）

git clone https://github.com/MonoYan/open-medkit.git
cd open-medkit
cp .env.example .env
# 可选：编辑 .env 设置 AI 默认值、MEDKIT_PORT 或代理变量
docker compose up -d --build

默认访问 http://localhost:3000。如果修改了 .env 中的 MEDKIT_PORT，请使用对应端口。

AI 配置在部署时是可选的，可以留空，之后在浏览器的设置面板中配置。

首次打开 Web UI 时，应用会自动检测当前浏览器时区并写入服务端；后续的过期判断、AI 问答中的"今天"以及每日提醒时间都会以这个业务时区为准。

本地开发

前置条件：Node.js >= 20

git clone https://github.com/MonoYan/open-medkit.git
cd open-medkit
npm install
cp .env.example .env
npm run dev

前端运行在 http://localhost:5173，后端运行在 http://localhost:3000。

如果你只通过 MCP / CLI / OpenClaw 使用 Open MedKit、从不打开 Web UI，请先初始化时区。未初始化时系统会回退到 UTC，不会使用服务器本地时区。

配置

所有 AI 配置也可以在浏览器的设置面板中设置。在浏览器中输入的值存储在当前浏览器的 localStorage 中，优先级高于环境变量。

MEDKIT_PORT 仅影响 Docker Compose 的宿主机端口映射。PORT 和 DB_PATH 用于源码 / 非 Docker 方式运行。

通知提醒

支持 Telegram / Discord / 飞书 / Email（SMTP 和 Resend）四种渠道，均在 Web UI 的 设置 → 通知提醒 中配置。

各渠道的详细配置步骤、常见邮箱参数和故障排查请参阅 通知提醒配置。

隐私与安全

• 药品数据默认存储在部署环境内的 SQLite 数据库中。
• AI 解析、图片识别和聊天功能会将提交的文本或图片发送到你配置的 OpenAI 兼容接口。
• AI 聊天还会发送回答问题所需的当前药品库存数据，请避免录入不希望与模型提供商共享的信息。
• 浏览器端的 AI 配置（如 AI_API_KEY、Base URL、模型名称）存储在当前浏览器的 localStorage 中。
• 通知提醒（Telegram / Discord / 飞书 / 邮件）启用后，会将药品名称、有效期和提醒文本发送到对应平台。
• Open MedKit 仅用于家庭药品库存管理，不提供诊断、处方或个性化用药建议。

部署

详细部署指南请参阅 部署文档。

快速部署 — 任何能运行 Docker 的机器：

docker compose up -d --build

数据持久化在 Docker 卷 (medkit-data) 中。备份方式：

docker cp medkit:/data/medicine.db ./medicine-backup.db

MCP Server（Agent 集成）

Open MedKit 内置 MCP 服务器，让 AI agent 直接通过 tool 调用管理药箱数据，无需打开浏览器。

已验证支持的客户端：

快速接入 — 在项目根目录创建 .mcp.json（Claude Code 自动识别）：

{
  "mcpServers": {
    "open-medkit": {
      "command": "npx",
      "args": ["tsx", "backend/src/mcp-server.ts"],
      "env": { "DB_PATH": "./backend/data/medicine.db" }
    }
  }
}

如果你通过浏览器使用，首次访问时会自动检测并保存浏览器时区。

如果你只通过 MCP 使用，建议第一次连接后先运行：

get_settings
set_timezone(timezone="Asia/Shanghai")

未初始化时区时，MCP 会明确提示当前只是回退到 UTC，而不是服务器本地时区。

详细文档：各客户端的完整配置方法、OpenClaw Skill 编写模板、对话示例、故障排查等，请参阅 MCP 使用指南。

项目结构

open-medkit/
├── backend/           # Hono API 服务器 + MCP 服务器
│   └── src/
│       ├── ai/        # AI 客户端、提示词、解析逻辑
│       ├── db/        # SQLite schema 与客户端
│       ├── routes/    # REST API 路由
│       ├── services/  # Telegram、Discord、飞书、邮件 & 通知调度
│       ├── middleware/ # API Key 注入
│       └── mcp-server.ts  # MCP 服务器（stdio 传输）
├── frontend/          # React 单页应用
│   └── src/
│       ├── components/
│       ├── hooks/
│       ├── lib/       # API 客户端 & 工具函数
│       └── types/
├── Dockerfile         # 多阶段构建
├── docker-compose.yml
└── .env.example

许可证

MIT

Star History

Powered by Star History