Supatask

🚀 ⚡ Supatask

Redisベースのローカルタスクマネージャーで、モダンなWebインターフェース、充実したCLI、MCPサーバー統合機能を備えています。

✨ 主な機能

• ✅ タスク管理：タグとステータス追跡を備えた完全なCRUD操作
• ⏱️ 時間追跡：タスクのタイマーの開始/停止と履歴追跡
• 📊 フィルタリング：ステータス、タグ、日付範囲でタスクをフィルタリング
• 📝 ログ記録：活動とシステムのログ記録と履歴分析
• 🌐 Webインターフェース：モダンでレスポンシブなダークモードのUI
• 💻 充実したCLI：テーブルと色付きの美しいコマンドラインインターフェース
• 🤖 MCPサーバー：Model Context Protocolを介したAIアシスタントの統合

🔧 技術詳細

アーキテクチャ

• バックエンド：FastAPI (Python 3.11+)
• データベース：AOF永続化を持つRedis
• フロントエンド：モダンなCSSを使用したVanilla JavaScript
• CLI：Typer + Rich
• デプロイメント：Docker Compose

🚀 クイックスタート

1. アプリケーションの起動

# Dockerコンテナを起動
docker compose up -d

# サービスが起動していることを確認
curl http://localhost:8000/health

2. Webインターフェースへのアクセス

ブラウザで http://localhost:8000 を開き、全機能を備えたWeb UIを利用できます。

3. CLIのインストール（オプション）

ワンラインインストール:

./install-cli.sh

手動インストール:

cd cli

4. CLIの使用

# タスクの一覧表示
python cli/supatask_cli.py list

# タスクの追加
python cli/supatask_cli.py add "Fix bug" --tags "urgent,backend"

# 時間追跡の開始
python cli/supatask_cli.py start 1

# 時間追跡の停止
python cli/supatask_cli.py stop 1

# ログの表示
python cli/supatask_cli.py logs --limit 20

💻 使用例

CLIコマンド

APIエンドポイント

タスク

• POST /tasks - タスクを作成
• GET /tasks - タスクを一覧表示（クエリパラメータ: status, tags, created_after, created_before）
• GET /tasks/{id} - タスクの詳細を取得
• PUT /tasks/{id} - タスクを更新
• DELETE /tasks/{id} - タスクを削除
• POST /tasks/{id}/start - タイマーを開始
• POST /tasks/{id}/stop - タイマーを停止

ログ

• GET /logs - ログを取得（クエリパラメータ: log_type, start_time, end_time, limit）

MCP (HTTP Streamable Transport)

• POST /mcp/ - JSON-RPC 2.0エンドポイント（initialize, tools/list, tools/call, ping）
• GET /mcp/ - サーバーからのメッセージ用のオプションのSSEストリーム

MCP統合

Supataskには、AIアシスタント統合用のHTTP Streamable Transport（MCP仕様2025-06-18）を実装したMCPサーバーが含まれています。

利用可能なツール

• create_task - タグ付きでタスクを作成
• read_task - タスクの詳細を読み取る
• list_tasks - フィルター付きでタスクを一覧表示
• update_task - タスクを更新
• delete_task - タスクを削除
• get_logs - 活動/システムログを取得

Claude Codeの設定

~/.config/claude-code/mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "supatask": {
      "url": "http://localhost:8000/mcp/",
      "transport": "http"
    }
  }
}

プロトコルの詳細

• 仕様：MCP 2025-06-18
• トランスポート：HTTP Streamable
• メッセージ形式：JSON-RPC 2.0
• セッション管理：Mcp-Session-Idヘッダーを介して行われます。

利用例

# 接続の初期化
curl -X POST http://localhost:8000/mcp/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}'

# 利用可能なツールの一覧表示
curl -X POST http://localhost:8000/mcp/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# タスクの作成
curl -X POST http://localhost:8000/mcp/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"create_task","arguments":{"title":"My Task","tags":["work"]}},"id":3}'

データモデル

タスクはRedisに以下の構造で保存されます。

task:{id}          タイトル、説明、ステータス、作成日時、更新日時を持つハッシュ
task:{id}:tags     タグのセット
task:{id}:time     時間追跡エントリのストリーム
tasks              すべてのタスクIDのセット
tasks:by_status:{status}  ステータス別のタスクIDのセット
logs:activity      ユーザー向けの活動ログのストリーム
logs:system        デバッグ/システムログのストリーム

📚 ドキュメント

開発

バックエンド開発

バックエンドは開発モードでホットリロードをサポートしています。

docker-compose up

backend/内のファイルを編集すると、サーバーが自動的にリロードされます。

アプリケーションの停止

docker-compose down

Redisのデータボリュームも削除する場合は、以下を実行します。

docker-compose down -v

設定

環境変数（docker-compose.ymlで設定）：

• REDIS_URL - Redisの接続URL（デフォルト: redis://redis:6379）
• LOG_LEVEL - ログレベル（デフォルト: INFO）

📄 ライセンス

MIT