Documentation Index
Fetch the complete documentation index at: https://docs.mirobody.ai/llms.txt
Use this file to discover all available pages before exploring further.
Mirobody 是什么？
Mirobody 是一个面向 个人 AI 的开源、可自托管的 数据与 Agent 引擎 ——我们相信下一代 AI 的关键不是知道更多关于世界的事，而是更了解 你。- 🔌 HTTP Remote MCP Server —— 写好的工具立即可被 ChatGPT、Claude、Cursor 等任何 MCP 客户端调用
- 🤖 原生 Agent 运行时 —— 本地复刻 Claude Code 的自主能力，并支持 Claude Agent Skills（
SKILL.md） - 🔄 可插拔数据源 —— 通过 Providers API 接入任意数据；已内置 300+ 可穿戴设备、Apple Health、Google Health，以及覆盖美国约 90% 病历的 EHR
- 🏥 医疗级标准 —— 400+ 健康指标统一对齐到 FHIR / LOINC / SNOMED CT / RxNorm，支持跨术语检索
Health、Finance & More. Mirobody 本身与领域无关：这份文档聚焦健康垂直（Theta Wellness 的底层），但同一套架构同样能驱动金融、法律、DevOps 等任何”个人数据 × AI”的垂直。把你的模块放进tools/和skills/即可开干。
快速开始
一行命令 Docker 部署，5 分钟跑起来
用例与示例
基于合成健康数据的真实对话片段
Provider 集成
几小时接入一种新设备或数据源
API 参考
Pulse、Chat、MCP 协议端点
为什么选 Mirobody？
一次写工具，到处都能用
一次写工具，到处都能用
不用写 JSON schema、不用做手动绑定 —— Python 代码本身就是定义。
tools/ 目录里的函数会同时在 ChatGPT（通过 Apps SDK）、Claude / Cursor（通过 MCP）以及本地 Web 客户端里可用。Mirobody 既是 MCP 客户端（消费工具），也是 OAuth 加持的 MCP 服务端（暴露工具）。数据完全留在你这里
数据完全留在你这里
引擎端到端在本地运行 —— Postgres、Redis、Agent 运行时、MCP 服务器、文件管线，全部自托管。LLM 可走 OpenRouter，也可直连 OpenAI、Gemini、Anthropic、Azure、火山引擎、阿里 Dashscope。没有任何第三方数据中转。
三种 Agent 各司其职
三种 Agent 各司其职
- DeepAgent —— 单模型工具编排，最擅长多步深度研究
- MixAgent —— 两阶段融合：一个强模型负责工具调用与数据收集，一个便宜模型负责生成回复；适合在高吞吐场景下平衡成本与质量
- BaselineAgent —— 不调工具、直连 LLM，适合低延迟 Q&A
原生支持 Claude Agent Skills
原生支持 Claude Agent Skills
在
skills/ 里丢一个 SKILL.md + metadata.json，Agent 就会自动发现并加载。Skill 正文会在被激活时整体写入上下文，可以放心写详细的步骤、示例和边界情况。多模态文件处理
多模态文件处理
支持 PDF、Excel、CSV、音频（WAV/MP3/AIFF/AAC/OGG/FLAC）、图像（PNG/JPEG/WebP/HEIC/HEIF）、基因数据。LLM 抽取自动把自由文本映射到标准指标。
代码沙箱执行
代码沙箱执行
内置
execute 工具把 shell 与 Python 跑在 E2B 云沙箱中，做数据分析、生成图表都没问题；文件写入由 PostgreSQL 持久化，上一轮 write_file 写下的内容下一轮 execute 可以直接读到。哪儿都能部署
哪儿都能部署
Docker 一行
./deploy.sh；本地 Python 开发用 pip install -e .；想公开 MCP 端点给 ChatGPT Apps，把 MCP_PUBLIC_URL=https://yourdomain.com 写进配置即可。架构总览
| 模块 | 路径 | 说明 |
|---|---|---|
| Agent 运行时 | mirobody/pub/agents/ | DeepAgent、MixAgent、BaselineAgent |
| LLM 客户端 | mirobody/utils/llm/ | OpenAI / Gemini / Anthropic / Azure / 火山 / Dashscope，含 HIPAA 合规路由 |
| MCP 服务器 | mirobody/mcp/ | JSON-RPC 2.0，本地 + HTTP 远程访问 |
| Chat 服务 | mirobody/chat/ | 会话、历史、HTTP/WebSocket 流式、记忆 |
| 数据管线 (Pulse) | mirobody/pulse/ | 300+ 设备、Apple/Google Health、EHR、文件解析、聚合 |
| 健康标准 | mirobody/indicator/、mirobody/pulse/core/ | 400+ 指标、FHIR/LOINC/SNOMED CT/RxNorm |
| Embeddings | mirobody/utils/embedding.py | 1024 维，Gemini/Qwen，pgvector 语义检索 |
| 目录 | 用途 |
|---|---|
tools/ | Python 工具 → 自动注册为 MCP 工具 |
skills/ | Claude Agent Skills（SKILL.md + metadata.json） |
agents/ | 自定义 Agent 实现 |
providers/ | 自定义数据 Provider |
prompts/ | Jinja2 prompt 模板 |
resources/ | 通过 MCP 暴露的静态资源 |
内置 Providers（健康垂直）
Garmin
活动、睡眠、心率、HRV
Whoop
恢复、睡眠、训练、周期
Oura
睡眠、状态、活动
Renpho
体成分、体重
Apple Health
iOS Health + CDA 病历
Google Health
Android 健康数据
技术栈
- Python 3.10+，全链路 async/await
- FastAPI / Starlette ASGI 作为 HTTP 层
- PostgreSQL 主存储 + pgvector 语义检索
- Redis 缓存与会话
- Docker Compose 一键部署
- E2B 代码沙箱执行
- OAuth 1.0a / 2.0 / OIDC / WebAuthn / FIDO2 多种鉴权
适用人群
个人用户
希望把健康数据收进自己手里、用 AI 看懂它，而不想交给第三方的人
开发者
构建”个人数据 × AI”产品的工程师，无论你做的是健康、金融、法律还是 DevOps
真实示例
下文示例使用 合成健康数据，部分用到了 Theta 的私有工具。
个人健康数据管理与对话
跨系统、跨年度追踪同一健康问题
跨系统、跨年度追踪同一健康问题
跨多个医疗系统、甚至跨国家查询同一个健康问题：
膝痛进展
在不同 Provider 间追踪膝痛进展
心血管历史
跨医疗系统监测心血管健康
统一的健康问题分析
统一的健康问题分析
把设备数据、病历、自述笔记合并到一起做分析：
心血管摘要
跨数据源汇总心血管状况
糖尿病历史与进展
从设备、病历、其他来源追踪糖尿病
为就诊做准备
为就诊做准备
PCP 就诊准备
给初级保健（PCP）就诊生成完整摘要与待问问题清单
个人健康深度研究
识别健康规律与驱动因素
识别健康规律与驱动因素
找出真正在帮助或拖累你的因素：
血糖分析
定位影响血糖的因子
症状与情绪驱动因素
发现症状与情绪背后的主导原因
个性化治疗研究
个性化治疗研究
糖尿病治疗选项
研究个性化的糖尿病管理方案（药物、设备、生活方式）
作为开发者数据引擎使用
可穿戴设备厂商
无需自建后端即可为你的设备添加 AI 对话能力
研究类应用
把自定义工具丢进
tools/，快速部署面向受试者的研究 App消费健康 App
以 Mirobody 作为数据 + AI 后端构建你的产品
企业级
定制集成与企业支持，请联系我们
Theta Wellness：Mirobody 的旗舰应用
Theta Wellness 是构建在 Mirobody 之上的旗舰健康智能 App，展示了引擎在生产级场景下的能力：300+ 设备、Apple/Google Health、EHR 病历，并支持语音、图像、文件、文字四种输入。 我们之所以开源引擎，是因为同一套支撑医疗级健康 Agent 的架构，同样可以驱动你的金融分析师、法律助理或 DevOps Bot。换掉tools/ 里的文件，你就进入了一个新的垂直。
下一步
开始上手
跟着 快速开始 用
./deploy.sh 跑起来。配置 Provider
给想接入的设备配 OAuth 凭据，参见 配置。
探索 API
阅读 API 参考 了解 Pulse、Chat 和 MCP 端点。
加自定义 Provider / 工具
新设备走 Provider 集成；新工具直接往
tools/ 丢一个 Python 文件即可。参与贡献
新 Provider、新工具、框架改进，都欢迎 PR。GitHub 仓库
源码、Issue、PR
贡献指南
如何提交变更
社区与支持
Discord
社区讨论（即将上线）
GitHub Issues
Bug 报告与功能请求
邮件支持
直接联系技术团队
本文档覆盖 Mirobody 的健康垂直。开源引擎仓库见 github.com/thetahealth/mirobody。