mcpField
M
maccabi-health

maccabi-health

本地服务
github.com健康医疗144 周前更新

关于 maccabi-health

maccabi-health 可通过命令行、库或 AI 助手读取 Maccabi Healthcare Services 的个人医疗记录,适用于希望查看自身检查与就诊资料的用户。它涵盖检验、处方、就诊、转诊及部分原始 PDF,并通过短信验证码登录。

主要功能

  1. 01读取检验结果及历史对比
  2. 02查看处方与配药记录
  3. 03读取就诊记录和转诊
  4. 04查看医生通信与文件
  5. 05读取影像检查元数据

适用场景

  1. 01查看血液检查数值、单位和参考范围
  2. 02整理处方及配药记录
  3. 03查阅医生问询与回复
  4. 04检索影像检查及系列信息

MCP 相关

可作为 MCP 服务接入 Claude、Codex、Gemini 等客户端,向其提供 Maccabi 医疗记录读取能力;也支持 loopback Streamable HTTP 与 OAuth。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"orenyomtov-maccabi-health": {
"command": "npx",
"args": [
"-y",
"maccabi-health"
]
}
}
}
启动命令npx -y maccabi-health

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmmaccabi-health0.1.6

工具

38

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Maccabi Health

请 AI 助手帮你再次查看化验结果、扫描影像、就诊记录、消息、转诊和处方。

npm license

通过命令行或 AI 助手读取你在 Maccabi Healthcare Services(以色列医疗基金)的记录:实验室检查历史、医生往来信件、就诊记录、处方、转诊,以及支持的原始 PDF。

这是非官方项目,与 Maccabi 无关。你需要身份证号码(תעודת זהות),以及能够接收登录验证码短信的手机。

开始使用

将以下内容复制并粘贴给你的 Agent:

Analyze my blood test results, and tell me if my cholesterol is a problem

https://raw.githubusercontent.com/orenyomtov/maccabi-health/main/skills/maccabi-health/SKILL.md

Claude Code、Cowork、Codex、Cursor、Instinct、Muse 和 ChatGPT Work 等 Agent 都可以执行。

也可以运行 npx skills add orenyomtov/maccabi-health 开始使用,该命令会将此技能安装到 Cursor、Claude Code、Codex 和其他本地 Agent 中。

安装并登录

npm install -g maccabi-health
maccabi-health login
maccabi-health labs --limit 10

或者,不进行全局安装:

npx -y maccabi-health login
npx -y maccabi-health labs --limit 10

maccabi-health login 会在终端中提示你输入身份证号码和短信验证码。如果 Agent 更希望用户直接在浏览器中登录,maccabi-health login --http 会输出一个 URL,用户可以通过该链接跳转登录。它会写入与 CLI 使用的相同会话文件。

如果全局安装后 maccabi-health 不在 PATH 中,请使用二进制文件的绝对路径,或继续使用 npx。

会话会过期

无论是否有活动,Maccabi 都会在登录一小时后结束每个会话。maccabi-health login 完成后会启动一个后台保活进程,在这一小时内每 240 秒续期一次,然后返回;这样后续命令可以继续工作,直到一小时结束。maccabi-health login --no-keep-alive 会跳过此操作。maccabi-health logout 会停止该进程。后台进程无法延长这一小时。测量结果见 SESSION-LIFETIME.md。

隐私

你在这里读取的每一条记录都是真实的医疗数据。你交给助手的任何内容都会成为该模型上下文的一部分,并被发送到该模型运行的位置。

带 Shell 的 Agent

Use the `maccabi-health` CLI to read my Maccabi records. 
Install with `npm install -g maccabi-health`. 
Run `maccabi-health` for the command index, `maccabi-health help` for the full reference, and `maccabi-health help COMMAND --json` for one command's exact arguments.

此场景下通常使用 CLI 更合适:没有工具数量限制,而且 Agent 已经可以筛选管道输出的 JSON 并进行循环处理。

MCP

claude mcp add maccabi-health -- npx -y maccabi-health mcp
codex mcp add maccabi-health -- npx -y maccabi-health mcp
gemini mcp add maccabi-health npx -y maccabi-health mcp

Cursor 配置示例,文件位于 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "maccabi-health": {
      "command": "npx",
      "args": ["-y", "maccabi-health", "mcp"]
    }
  }
}

maccabi-health mcp --http 会通过 OAuth 提供回环 Streamable HTTP 服务;详见 MCP.md。

库

安装方式:

npm install maccabi-health

用法示例:

import { connect, login } from "maccabi-health";

const pending = await login(idNumber);
await pending.sms();
const client = await pending.verify(smsCode);

const tests = await client.listTests({ year: 2025 });

pending.phones 会列出短信接收号码;有多个号码时,将 index 传给 sms()。验证码错误会结束本次尝试。

你可以保存 await client.exportSession(),之后再通过 connect(session) 打开。

这些方法读取的内容与 CLI 相同。

功能

读取内容示例
检查结果数值、日期、单位、参考范围、历史对比和 PDF
药物处方、配药记录和符合条件的 PDF
病历就诊记录、疫苗接种、转诊和摘要
往来信件支持的医生咨询、回复和文档
账单季度报告和报告 PDF
影像检查列表、序列和单张影像元数据。预览 JPEG 和原始像素文件仅支持 CLI;目前仅对 8 位超声进行过实时验证
其他读取内容证明、通知、设置和公开的医疗服务提供者搜索(经常会被机器人验证拦截)

请参阅完整功能参考。

遇到问题?

修复这个 bug 并提交 pull request。这比只创建 issue 更好:每个账户的记录都不同,因此维护者通常无法复现你遇到的问题。请参阅贡献指南。

如果无法修复,请创建 issue。切勿粘贴病历、身份证号码、Cookie 或会话文件。安全问题请通过 SECURITY.md 提交。

所有文档 · 身份验证 · CLI 指南 · MCP 传输方式 · 更新日志 · API 来源 · 贡献指南 · MIT 许可证

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。