Lifeup MCP

🚀 LifeUp MCPサーバー

ローカルネットワーク上でClaudeがLifeUp Cloud APIとやり取りできるMCPサーバーです。タスクの作成、クエリ、達成条件のマッチングをサポートしています。

🚀 クイックスタート

1. インストール

npm install && npm run build

2. 設定

cp .env.example .env

LIFEUP_HOSTをAndroidデバイスの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' に設定

トラブルシューティング

接続に失敗しましたか？

• LifeUpがHTTP APIを有効にして実行されていることを確認してください。
• 両方のデバイスが同じネットワーク上にあることを確認してください。
• .env ファイルの LIFEUP_HOST を確認し、必要に応じて更新してください。

達成条件のデータが利用できませんか？

• 一部のLifeUpバージョンではこれが想定されており、サーバーはカテゴリにフォールバックします。

デバッグエラーが発生しましたか？

DEBUG=true npm run start

セーフモード

SAFE_MODEは誤ったデータ変更から保護します。

• 有効 (SAFE_MODE=true): 読み取り操作と新しいエンティティ（タスク、達成条件、ショップアイテム）の作成を許可します。既存のデータの編集と削除はブロックされます。
• 無効 (SAFE_MODE=false): 編集と削除を含むすべての20のツールに完全にアクセスできます。

Claudeに計画/作成を支援してもらいたいが、既存のデータを変更したくない場合やテストに役立ちます。

リンク

• LifeUp Docs
• LifeUp SDK
• CLAUDE.md - 開発者ガイド

📄 ライセンス

MIT