Lifeup MCP

🚀 LifeUp MCP 服務器

LifeUp MCP 服務器可讓 Claude 在本地網絡中與 LifeUp 雲 API 進行交互。它支持任務創建、查詢以及成就匹配等功能。

🚀 快速開始

1. 安裝

npm install && npm run build

2. 配置

cp .env.example .env

將 LIFEUP_HOST 更新為你的安卓設備 IP（可在 LifeUp 設置 → HTTP API 中找到）。

3. 運行

npm run start

✨ 主要特性

任務管理

• create_task - 創建帶有獎勵的新任務
• list_all_tasks - 列出所有任務
• search_tasks - 根據條件篩選任務
• get_task_history - 查看已完成的任務
• get_task_categories - 列出任務類別

成就相關

• list_achievements - 列出所有成就
• match_task_to_achievements - 為任務查找匹配的成就

用戶信息

• get_user_info - 獲取用戶資料和等級
• list_skills - 查看技能及進度
• get_coin_balance - 獲取當前金幣餘額

商店功能

• list_shop_items - 瀏覽商品
• get_shop_categories - 查看商品類別
• search_shop_items - 搜索商品

安全操作

• edit_task - 編輯現有任務
• create_achievement - 創建新成就
• update_achievement - 更新成就
• delete_achievement - 刪除成就
• add_shop_item - 創建商店商品
• edit_shop_item - 修改商店商品
• apply_penalty - 應用資源懲罰
• edit_skill - 管理技能

📦 安裝指南

環境變量

LIFEUP_HOST=10.103.2.235      # 設備 IP
LIFEUP_PORT=13276              # API 端口
LIFEUP_API_TOKEN=              # 可選的認證令牌
DEBUG=false                     # 設置為 'true' 以啟用日誌記錄
SAFE_MODE=false                 # 設置為 'true' 以禁用編輯/刪除操作

💻 使用示例

基礎用法

在配置好環境變量並完成安裝後，可通過以下命令啟動服務器：

npm run start

高級用法

若需要調試錯誤信息，可使用以下命令：

DEBUG=true npm run start

📚 詳細文檔

故障排除

連接失敗？

• 確保 LifeUp 已開啟 HTTP API 並正在運行。
• 驗證兩臺設備是否處於同一網絡。
• 檢查並更新 .env 中的 LIFEUP_HOST。

成就數據不可用？

某些 LifeUp 版本可能會出現此情況，服務器會回退到類別模式。

安全模式

SAFE_MODE 可防止意外的數據修改：

• 啟用（SAFE_MODE=true）：允許進行讀取操作以及創建新實體（任務、成就、商店商品），但禁止編輯和刪除現有數據。
• 禁用（SAFE_MODE=false）：可完全訪問所有 20 個工具，包括編輯和刪除操作。

安全模式在測試時或你希望 Claude 僅協助規劃/創建而不修改現有數據時非常有用。

鏈接

• LifeUp 文檔
• LifeUp SDK
• CLAUDE.md - 開發者指南

📄 許可證

本項目採用 MIT 許可證。