neiltron/apple-health-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

575 stars 24 forks Качество 78 Тренд 35MIT

Локальный сервер Apple Health MCP. Позволяет AI-ассистентам отвечать на вопросы о вашем сне, тренировках, активности и сердечных данных из локального экспорта.

Обзор

Сервер MCP (Model Context Protocol) для запроса данных Apple Health с использованием SQL. Построен с использованием DuckDB для быстрого и эффективного анализа данных о здоровье. В настоящее время этот проект основан на приложении Simple Health Export CSV Эрика Вольтера. См. раздел «Экспорт данных» ниже для получения дополнительной информации о том, как лучше всего использовать приложение. Сейчас это самый простой способ, который я смог найти, чтобы быстро и надёжно экспортировать данные Apple Health в формате CSV. Если у вас есть идеи по более эффективным способам импорта данных, пожалуйста, подайте проблему. - : Ваш MCP-клиент переводит ваши вопросы в запросы к базе данных - : Прямые SQL-запросы к вашим данным Apple Health - : Генерируйте еженедельные/ежемесячные сводки по состоянию здоровья - : Ленивые загрузки с настраиваемыми временными окнами - : Кэширование результатов запросов с помощью TTL Установка не требуется! Используйте напрямую с NPX через Claude Desktop или другие MCP-клиенты. Добавьте к вашей конфигурации Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.

Обзор (машинный перевод)

Запрос данных Apple Health из MCP-клиента с использованием SQL и DuckDB. Сервер работает локально читает экспорт CSV по запросу и предоставляет инструменты для поиска схем, аналитические запросы и обзоры здоровья.

Требования

Node.js 22 или новее
Экспорт Apple Health CSV, созданный с помощью Simple Health Export CSV

Родной формат Apple Health export.xml в настоящее время не поддерживается.

Настроить MCP-клиент

Для Claude Desktop добавьте следующее: ~/Library/Application Support/Claude/claude_desktop_config.json:

Перезапустить клиент после изменения его конфигурации. Другие клиенты MCP могут использовать та же команда, аргументы, окружение и stdio транспорт.

Переменные среды

Переменная	Требуется	По умолчанию	Цель
`HEALTH_DATA_DIR`	Да	—	Каталог с экспортированными CSV-файлами
`MAX_MEMORY_MB`	Нет	`2048`	Лимит памяти DuckDB в мегабайтах
`CACHE_SIZE`	Нет	`100`	Максимальное количество кэшированных результатов запросов

Экспорт данных здоровья

Установите и откройте Simple Health Export CSV на вашем iPhone.
Выберите Все и выберите временной диапазон для экспорта.
Перенесите архив на компьютер с вашим MCP-клиентом.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Apple Health MCP Server

Query Apple Health data from an MCP client using SQL and DuckDB. The server runs locally, reads CSV exports on demand, and provides tools for schema discovery, analytical queries, and health summaries.

Requirements

Node.js 22 or newer
An Apple Health CSV export created with Simple Health Export CSV

The native Apple Health export.xml format is not currently supported.

Configure an MCP client

For Claude Desktop, add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["-y", "@neiltron/apple-health-mcp"],
      "env": {
        "HEALTH_DATA_DIR": "/path/to/your/unzipped/health-export"
      }
    }
  }
}

Restart the client after changing its configuration. Other MCP clients can use the same command, arguments, environment, and stdio transport.

Environment variables

Variable	Required	Default	Purpose
`HEALTH_DATA_DIR`	Yes	—	Directory containing the exported CSV files
`MAX_MEMORY_MB`	No	`2048`	DuckDB memory limit in megabytes
`CACHE_SIZE`	No	`100`	Maximum number of cached query results

Export health data

Install and open Simple Health Export CSV on your iPhone.
Select All and choose the time range to export.
Transfer the archive to the computer running your MCP client.
Unzip it and set HEALTH_DATA_DIR to the resulting directory.

The server reads the files in place. It does not upload the export or make network requests, although query results returned to your MCP client may be sent to that client’s configured model provider.

Tools

Tool	Purpose
`health_schema`	Discover table names, columns, units, and sample rows
`health_query`	Run one DuckDB SELECT-family analytical statement with JSON, CSV, or summary output
`health_report`	Generate a weekly, monthly, or custom health summary

Start with health_schema; table names depend on the files in your export. See Querying Apple Health data for the data model and working examples.

health_query accepts one DuckDB analytical statement. See Query safeguards for supported statements and restricted operations.

Query safeguards

The server limits DuckDB file access to HEALTH_DATA_DIR. It also disables network access and temporary disk storage, and it locks the database settings.

Открыть полный README на GitHub

Установка

npx -y @neiltron/apple-health-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "apple-health": {
      "command": "npx",
      "args": ["-y", "@neiltron/apple-health-mcp"],
      "env": {
        "HEALTH_DATA_DIR": "/path/to/your/unzipped/health-export"
      }
    }
  }
}