Oncofiles

oncofiles

您的医疗记录散落在 Gmail、Google Drive 和 Calendar 中。Oncofiles 会读取所有内容、整理归档，并通过 AI 提供访问途径——因此您可以在 Claude 或 ChatGPT 中自然地询问自己的健康状况。

oncofiles.com | 演示仪表板 | 隐私政策

这是什么？

Oncofiles 是一款专为癌症患者及其照护者打造的 MCP 服务。它连接到您的 Google Drive、Gmail 和 Calendar，读取所有医疗文档（化验结果、CT 扫描、病理报告、处方），并让您通过任意 AI 聊天工具访问这些内容——Claude、ChatGPT 或任何 MCP 客户端。

源于真实需求： 由一位负责管理妻子癌症治疗的照护者创建。数百份文档、数十位医生，以及不断变化的化验结果。Oncofiles 将这些纷乱的信息整理起来，让您专注于治疗，而非寻找文件。

姊妹项目： Oncoteam——一款 AI Agent，可分析您的 Oncofiles 数据：追踪化验趋势、搜索临床试验，并为您准备咨询肿瘤科医生的问题。

您的数据，由您掌控： 所有数据都保留在您的 Google Drive 中。不进行第三方数据处理。您可随时断开连接——您的文件始终归您所有。

多患者支持（v4.0+）

Oncofiles 支持在单个实例中管理多位患者。每位患者都拥有：

• 完整的数据隔离——文档、化验结果、治疗事件、邮件和日历条目均按患者分别管理
• 独立的 bearer token——每位患者（或照护者）都有自己的 onco_* token
• 按患者配置 OAuth——每位患者分别授权 Google Drive、Gmail 和 Calendar
• 仪表板患者选择器——在 Web 仪表板中切换患者

为新患者办理接入

1. 仪表板向导： 打开仪表板，点击“+ New Patient”，并按照 4 步向导操作
2. API： 使用 {patient_id, display_name} 调用 POST /api/patients——返回 bearer token
3. 连接 GDrive： 访问 /oauth/authorize/drive?patient_id=X，授权文档同步
4. 触发首次同步： 使用 {patient_id} 调用 POST /api/sync-trigger，导入文档

功能

• 76 个 MCP 工具，涵盖 14 个模块，全面管理医疗数据
• 14 种文档类别——化验、病理、影像、遗传、手术、会诊、处方等
• 化验值追踪——存储数值、追踪趋势，并对化疗方案执行周期前安全检查
• Google Drive 同步——双向同步，并自动生成 OCR 配套文件
• Gmail 和 Calendar 扫描——自动检测并分类医疗邮件和预约
• 临床研究——搜索 PubMed 和 ClinicalTrials.gov，记录研究决策
• 治疗时间线——追踪化疗周期、手术及其他治疗事件
• 文档版本管理——追踪文档修订并保留完整历史记录
• AI 驱动的元数据——自动生成摘要和标签，并提取结构化数据
• 审计日志——记录每次工具调用，以便追责

架构

┌─────────────────┐     MCP Protocol      ┌──────────────┐
│  Claude / GPT   │◄────────────────────►  │  Oncofiles   │
│  (AI Assistant)  │    streamable-http     │  MCP Server  │
└─────────────────┘                        └──────┬───────┘
                                                  │
                                    ┌─────────────┼─────────────┐
                                    │             │             │
                              ┌─────▼─────┐ ┌────▼────┐ ┌─────▼─────┐
                              │  SQLite /  │ │ Google  │ │ Anthropic │
                              │   Turso    │ │  Drive  │ │ Files API │
                              └───────────┘ └─────────┘ └───────────┘

技术栈： Python 3.12+ · FastMCP 3.1 · Pydantic · SQLite/Turso · Railway

快速开始

# Clone and install
git clone https://github.com/peter-fusek/oncofiles.git
cd oncofiles
uv sync --extra dev

# Run locally (stdio mode for Claude Desktop)
uv run oncofiles-mcp

# Run tests
uv run pytest

# Lint
uv run ruff check

环境变量

# Required
DATABASE_PATH=data/oncofiles.db

# Optional — cloud database
TURSO_DATABASE_URL=libsql://...
TURSO_AUTH_TOKEN=...

# Optional — Google Drive sync
GOOGLE_DRIVE_FOLDER_ID=...
GOOGLE_OAUTH_CLIENT_ID=...
GOOGLE_OAUTH_CLIENT_SECRET=...

# Optional — remote access
MCP_TRANSPORT=streamable-http  # default: stdio
MCP_HOST=0.0.0.0
MCP_PORT=8080
MCP_BEARER_TOKEN=...

连接到 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "oncofiles": {
      "command": "uv",
      "args": ["run", "oncofiles-mcp"],
      "cwd": "/path/to/oncofiles"
    }
  }
}

连接到 ChatGPT

Oncofiles 支持 ChatGPT 的 MCP 集成（Developer Mode）。将 ChatGPT 指向你实例的 /mcp 端点，并提供 bearer token。

部署到 Railway

随附的 Dockerfile 已可用于 Railway 部署：

1. 推送到 GitHub
2. 在 Railway 中连接仓库
3. 设置环境变量
4. Railway 会在推送时自动部署

在线实例：oncofiles.com

项目结构

src/oncofiles/
├── server.py           # FastMCP server, auth, routes, scheduler
├── database/           # Mixin-based DB layer (SQLite/Turso)
├── tools/              # 14 tool modules (76 tools)
│   ├── documents.py    # CRUD, search, view, versioning
│   ├── lab_trends.py   # Lab values, trends, safety checks
│   ├── clinical.py     # Treatment events, research log
│   ├── research.py     # PubMed, ClinicalTrials.gov search
│   └── ...
├── sync.py             # Bidirectional Google Drive sync
├── gmail_sync.py       # Medical email detection and import
├── calendar_sync.py    # Calendar event classification
├── enhance.py          # AI metadata extraction (Haiku)
├── patient_middleware.py # Per-patient token → context resolution
├── patient_context.py  # Patient clinical profile
└── models.py           # Pydantic models

MCP Registry

已作为 io.github.peter-fusek/oncofiles 列入 MCP Registry。

贡献

请参阅 CONTRIBUTING.md 了解指南。

许可证

MIT

---

关于团队

团队成员

Peter Fusek — 首席执行官兼创始人 连续创业者和 AI 战略师。在 Tatra banka 工作了 4 年。共同创立 marketlocator（后出售给 Deutsche Telekom）。担任 VÚB Bank 首席执行官的顾问。拥有 18 年以上打造技术产品的经验。 Oncofiles 源于个人需求——他需要管理妻子的癌症治疗，涉及数百份文档、数十位医生以及不断变化的实验室检查结果。 LinkedIn · [email protected]

Peter Čapkovič — 首席技术官兼联合创始人 资深 IT 架构师，在企业银行领域（VÚB）拥有 20 多年经验。精通 .NET、Python、SQL 和系统架构。负责 Instarea 所有产品的架构设计。 架构、开发、运维——一站式完成。 LinkedIn

公司

Instarea — 18 年来已推出 23 款产品。从电信分析和企业客户（Callinspector），到移动优先的金融科技产品（InventButton）、大数据领域的退出案例（marketlocator → Deutsche Telekom）、物联网平台，以及 AI 优先产品（PulseShape、ReplicaCity、HomeGrif）。

Oncofiles 和 Oncoteam 是 Instarea 的最新产品——它们秉承同样严谨的工程规范，打造出服务于银行、电信和数据行业的企业级产品。

现有 10 多名经过验证且协同工作的团队成员，可提供前端、后端、集成、数据科学、UX/UI、营销和云运维方面的支持。

“我们用心对待每一件事，以家人般的态度投入工作，也坦诚面对彼此。”

由 Instarea 打造 | 符合 EHDS 原则