健康数据导出服务

通过TCP服务器或MCP协议将iPhone/iPad上的健康数据导出到其他应用(如Claude桌面应用)的服务。

  • by HealthyApps
  • TypeScript
  • 本地部署
  • 68 星标
  • 更新于
在 GitHub 查看 HealthyApps/health-auto-export-mcp-server

使用说明

健康汽车出口

本项目提供了如何在中使用TCP服务器的示例 健康汽车出口 iPhone/iPad应用程序。

您可以直接通过TCP向服务器进行查询,也可以通过MCP将项目连接到LLM,例如用于桌面的Claude应用程序。

在 /docs 您将在文件夹中找到更详细的说明。

运行此项目

先决条件

  • Node.js:版本18或更高版本
  • npm:附带Node.js
  • 健康自动导出应用程序:安装在具有高级访问权限的iPhone/iPad上
  • 网络接入:您的计算机和移动设备必须位于同一Wi-Fi网络上

安装

  1. 克隆存储库:

    git clone <repository-url>
    cd health-auto-export-mcp-server
    
  2. 安装依赖项:

    npm install
    
  3. 配置 .env 文件:

    • 复制 .env.example 文件并将其重命名为 .env
    • 为设置适当的值 HAE_HOST (您的设备IP地址)
  4. 构建项目:

    npm run build
    
  5. 运行开发服务器:

    npm run dev
    

用法

传输控制协议

client_example.ts 提供了一个通过TCP连接到健康自动导出服务器的客户端示例。

  1. 使用以下方式构建项目 npm run build
  2. 使用以下命令运行客户端 node ./dist/client_example.js
  3. 扩展代码以构建自己的集成

配置Claude MCP

有关MCP工具名称和1.0.0中的突破性更改,请参阅 CHANGELOG.md.执行生活在 src/server.ts.

  1. 使用以下方式构建项目 npm run build

  2. 导航至 Settings -> Developer -> Edit Config

  3. 这应该打开 claude_desktop_config.json

  4. 添加MCP服务器详细信息,如下所示,指向您设置此项目的磁盘上的正确路径:

    {
      "mcpServers": {
        "health_auto_export": {
          "command": "node",
          "args": ["/Users/username/Desktop/hae-mcp/dist/server.js"]
        }
      }
    }
    
  5. 重新启动克劳德桌面

  6. 使用MCP时,请记住Claude的上下文窗口限制。这意味着可能需要适当地聚合数据以处理请求。

  7. 有关Claude Desktop MCP配置的更多信息