JinDaGe - lifeup-mcp MCP Details

article

README

🚀 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 许可证。

lifeup-mcp