@fukuchang/taskchute-mcp 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.1.2 (Unreleased)
+
+CLI (`@fukuchang/taskchute-cli`) と歩調を揃えるため、初回リリースのバージョン
+を 0.1.0 ではなく 0.1.2 から開始する。以降は SemVer に従って独立に bump する。
+
+- Initial release. 5 tools 公開:
+  - `list_tasks(date?)` — 指定日 (省略時は今日) のタスク一覧を返す
+  - `add_task(title, date?, estimated_seconds?, description?)` — タスク追加
+  - `start_task(id)` — 計測開始 (status → running)
+  - `pause_task(id)` — 一時停止 (status → paused)
+  - `done_task(id)` — 完了 (status → completed)
+- 認証: env `TASKCHUTE_SUPABASE_URL` / `TASKCHUTE_SUPABASE_PUBLISHABLE_KEY` 必須。
+  session 永続化は CLI (`@fukuchang/taskchute-cli`) と同じ OS keyring
+  (`taskchute-cli` service) を共有するため、`taskchute login` 済なら追加操作不要。
+- E2EE: passphrase は env `TASKCHUTE_PASSPHRASE` か CLI `taskchute unlock` で keyring
+  に保存したものを使う。stdio MCP の制約で対話 prompt は提供しない。
+- 配布形態: tsup で single-file bundle (`dist/index.js`, ~72 KB)。
+  workspace deps (crypto / domain / infra-supabase) は bundle 内に取り込み、
+  native module / wasm / 大型 SDK (`@modelcontextprotocol/sdk` / `@napi-rs/keyring`
+  等) は external で npm dependencies 経由配布。

package/README.md

@@ -0,0 +1,86 @@
+# @fukuchang/taskchute-mcp
+
+TaskChute MCP server — [Model Context Protocol](https://modelcontextprotocol.io/) 経由で
+E2EE 暗号化された TaskChute タスクを Claude Desktop / Claude Code 等から操作するためのサーバー。
+
+> **Status:** 0.1.2 (initial release, PR 13). 提供 tool は `list_tasks` / `add_task` /
+> `start_task` / `pause_task` / `done_task` の 5 つ。npm 公開は PR 14 で実施予定。
+> 初回バージョンを 0.1.2 から始めるのは、CLI (`@fukuchang/taskchute-cli`) と
+> 歩調を揃えるため (以降は独立 SemVer)。
+
+## 提供 tool
+
+| tool | 説明 |
+| --- | --- |
+| `list_tasks` | 指定日 (省略時は今日) のタスク一覧を返す |
+| `add_task` | タスクを追加する (title, date?, estimated_seconds?, description?) |
+| `start_task` | タスクの計測を開始する (status → running) |
+| `pause_task` | タスクを一時停止する (status → paused) |
+| `done_task` | タスクを完了する (status → completed) |
+
+入力 `id` は full UUID。`list_tasks` の結果から取って `start_task` / `pause_task` /
+`done_task` に渡す想定。`estimated_seconds` は秒数の整数 (CLI と違って文字列パースは
+しない)。
+
+## 認証 / E2EE
+
+CLI と同じ OS keyring (`taskchute-cli` service) を読むため、事前に CLI で
+セットアップしておくのが最短:
+
+```bash
+# 1. ログイン (session を keyring に保存)
+TASKCHUTE_SUPABASE_URL=... TASKCHUTE_SUPABASE_PUBLISHABLE_KEY=... taskchute login
+
+# 2. E2EE unlock (passphrase を keyring に保存)
+taskchute unlock
+```
+
+MCP server を単独で動かす場合は env だけで完結する:
+
+- `TASKCHUTE_SUPABASE_URL` (必須)
+- `TASKCHUTE_SUPABASE_PUBLISHABLE_KEY` (必須)
+- `TASKCHUTE_PASSPHRASE` (任意。keyring に保存済なら不要)
+
+MCP は対話 prompt を持てないため、env か keyring のどちらにも passphrase が
+ない場合は最初の tool 呼び出しで `McpToolError` を返す。
+
+## ローカル開発 (PR 13 時点)
+
+```bash
+# build
+pnpm --filter @fukuchang/taskchute-mcp build
+
+# 動作確認 (Claude Code の .mcp.json から起動)
+cp .mcp.json.example .mcp.json   # repo root で
+# .mcp.json の env を実値で埋めてから Claude Code を再起動
+```
+
+`.mcp.json` の最小例 (Claude Code 用):
+
+```json
+{
+  "mcpServers": {
+    "taskchute": {
+      "command": "node",
+      "args": [
+        "/path/to/TaskChute/packages/mcp/dist/index.js"
+      ],
+      "env": {
+        "TASKCHUTE_SUPABASE_URL": "https://YOUR_PROJECT.supabase.co",
+        "TASKCHUTE_SUPABASE_PUBLISHABLE_KEY": "sb_publishable_..."
+      }
+    }
+  }
+}
+```
+
+## 設計メモ
+
+- handler は pure function (`(ctx, input) => output`) に切り出して、MCP SDK
+  レイヤーから独立してテスト可能にしている
+- 認証/E2EE wireup は CLI の `createAppContext` を MCP 側に複製したもの。
+  PR 15 以降で `@taskchute/infra-supabase` (もしくは新 `@taskchute/node-shared`)
+  に共通化する想定 — `feedback-iteration-then-redesign` に従いまず動作確認を優先
+- AppContext は MCP server プロセス内で **1 度だけ** 構築して再利用する
+  (Argon2id 再実行コストを毎回払わない設計)
+- 出力 JSON は snake_case + ISO 8601 文字列 (FastMCP / Python MCP との慣習揃え)