Homra Heartbeat 2.0 MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/fadedchange0aran-netizen/homra-heartbeat.git
cd homra-heartbeat
pip install -r requirements.txt
python server.py
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add homra-heartbeat -- python "<FULL_PATH_TO_HOMRAHEARTBEATAI>/dist/index.js"

Replace <FULL_PATH_TO_HOMRAHEARTBEATAI>/dist/index.js with the actual folder you prepared in step 1.

README.md

A full-stack personal assistant system for system monitoring and notifications.

🖤 Homra Heartbeat 2.0 (Universal Repository)

这是一个全栈个人助手系统，集成了：

  • Python 后端: 管理 API、持久化配置、动态定时任务。
  • React 仪表盘: 远程更新配置、手动触发推送、记录日记。

🚀 快速开始

1. 克隆并运行 (VPS 端)

git clone https://github.com/YOUR_USER/homra-heartbeat.git
cd homra-heartbeat

# 安装依赖
pip install -r requirements.txt

# 启动服务
python server.py

2. 配置与部署

  • 默认端口为 8000。
  • 首次运行会自动创建 config.json。
  • 访问 http://YOUR_IP:8000/ 即可进入管理后台。

3. 如何在前端修改后即时生效？

  1. 在 Aran Config 标签页修改参数（如把早安时间改为 06:00）。
  2. 点击右上角的 "Sync to Server" 按钮。
  3. 后端会自动保存配置并重载定时器，无需重启。

🛠️ 技术细节

  • Persistence: 所有的修改都保存在服务器本地的 config.json。
  • Auto-Sync: 前端加载时会自动尝试同步服务器最新的配置。
  • Dynamic Scheduler: 使用 APScheduler 实现不重启重载任务。

Configuration

claude_desktop_config.json
{"mcpServers": {"homra-heartbeat": {"command": "python", "args": ["/path/to/homra-heartbeat/server.py"]}}}

Try it

→Check the current status of my system heartbeat.
→Update my notification configuration to send alerts to PushPlus.
→Trigger a manual notification update through the dashboard.
→Sync my latest configuration changes to the server.

Frequently Asked Questions

What are the key features of Homra Heartbeat 2.0?

Real-time system monitoring and heartbeat tracking. Automated notifications via PushPlus and Notion. Dynamic task scheduling using APScheduler without requiring restarts. React-based dashboard for remote configuration management. Persistent configuration storage in local JSON files.

What can I use Homra Heartbeat 2.0 for?

Automating daily morning routine notifications. Monitoring server uptime and system health remotely. Managing personal task schedules through a centralized dashboard. Syncing configuration changes across multiple devices without service downtime.

How do I install Homra Heartbeat 2.0?

Install Homra Heartbeat 2.0 by running: git clone https://github.com/fadedchange0aran-netizen/homra-heartbeat.git && cd homra-heartbeat && pip install -r requirements.txt && python server.py

What MCP clients work with Homra Heartbeat 2.0?

Homra Heartbeat 2.0 works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Homra Heartbeat 2.0 docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all monitoring servers →

Related MCP Servers

Skylos
Find dead code, secrets, and exploitable flows in Python, TypeScript, and Go.
monitoring344 stars
Linux MCP Server
Read-only Linux system administration and diagnostics on RHEL-based systems.
monitoring189 stars
Charles MCP Server
Integrates Charles Proxy with MCP clients for real-time network traffic analysis
monitoring118 stars
HomeButler
All-in-one homelab management MCP server.
monitoring64 stars
Wireshark MCP
Give your AI assistant a packet analyzer.
monitoring55 stars
RenderDoc MCP
Analyze GPU frame captures for graphics debugging and performance analysis.
monitoring42 stars