level-up-mcp-server-cn 0.4.0 → 0.4.2

package/CLAUDE.md

@@ -10,7 +10,8 @@ Level-Up is a gamification MCP server that tracks XP, levels, skills, and quests
 - **Database**: Supabase (Postgres) — 45 tables, RLS enabled
 - **Transport**: stdio (default, for Claude Desktop/OpenClaw) + Streamable HTTP (Express, for remote)
 - **Security**: Critical writes (XP, levels, achievements) go through Postgres SECURITY DEFINER functions via `supabase.rpc()`. Anon key users cannot directly modify XP/level tables.
-- **Distribution**: npm package `level-up-mcp-server`, zero-config with hardcoded anon key fallback
+- **Distribution**: npm packages `level-up-mcp-server` (English) + `level-up-mcp-server-cn` (Chinese), zero-config with hardcoded anon key fallback
+- **Localization**: English (main branch, locale=en) + Chinese (zh-cn branch, locale=zh)
 
 ## File Structure
 
@@ -25,22 +26,27 @@ src/
 │   ├── supabase.ts             # Supabase client (anon key hardcoded as fallback)
 │   ├── errors.ts               # Error handling helpers (ok, fail, handleSupabaseError)
 │   ├── format.ts               # Pagination and formatting helpers
+│   ├── ownership.ts            # Ownership verification (verifyOwnership helper)
+│   ├── quality-gate.ts         # Quality gate checks for task evidence
 │   ├── rate-limit.ts           # Sliding window rate limiter (per-entity, 10min windows)
 │   └── register.ts             # Tool registration helpers (toMcpResponse, logRegistered)
 └── tools/
     ├── users.ts                # Section 1: 13 user tools
-    ├── agents.ts               # Section 2: 3 agent tools
+    ├── agents.ts               # Section 2: 4 agent tools
     ├── skills.ts               # Section 3: 6 skill tools
-    ├── tasks.ts                # Section 4: 7 task tools (XP awarded here via RPC)
+    ├── tasks.ts                # Section 4: 10 task tools (XP awarded here via RPC)
     ├── ratings.ts              # Section 5: 7 rating tools
     ├── quests.ts               # Section 6: 12 quest tools (NOT ACTIVE YET)
     ├── metrics.ts              # Section 7: 3 metrics tools
     ├── xp.ts                   # Section 8: 5 XP/progression tools
     ├── leaderboards.ts         # Section 9: 1 leaderboard tool
     ├── leveling.ts             # Section 10: 3 leveling tools
-    ├── achievements.ts         # Section 11: 1 achievement tool
+    ├── achievements.ts         # Section 11: 2 achievement tools
     ├── admin.ts                # Section 12: 5 admin tools
-    └── system.ts               # Section 13: 3 system tools (level-up check via RPC)
+    ├── system.ts               # Section 13: 4 system tools (level-up check via RPC)
+    ├── bootstrap.ts            # Section 14: 2 onboarding tools (setup wizard)
+    ├── growth-plan.ts          # Section 15: 2 growth plan tools
+    └── dispatchers/            # 8 category dispatchers (token-efficient tool routing)
 ```
 
 ## Core Data Flow
@@ -110,37 +116,44 @@ These bypass RLS and are the ONLY way to modify XP/level data:
 4. `register_user_secure(...)` — Atomic user creation
 5. `register_agent_secure(...)` — Agent creation with owner validation
 
-## Current Status (as of March 14, 2026)
+## Current Status (as of March 21, 2026)
 
 ### Working
 - All 69 MCP tools compile and register
-- User registration, agent creation, skill management
+- User registration via `register_user_secure` RPC (with direct insert fallback)
+- Agent creation via `register_agent_secure` RPC (with direct insert fallback)
 - Task lifecycle (start → update → complete → fail)
 - XP calculation via Postgres RPC (anti-cheat)
 - Level-up via Postgres RPC (uses cumulative_xp correctly)
+- Agent XP — `start_task` accepts agent_id, `inferPerformerType()` correctly sets performer_type, XP splits work
+- Star display — `formatRankDisplay()` returns ★/☆ string + stars_earned/stars_total in get_user_progress, get_agent_profile, check_level_up
+- Achievement auto-triggers — 5 task-count achievements after complete_task, ~11 level/rank achievements after check_level_up
+- Ownership verification on 21 tools via `verifyOwnership()` helper
+- Admin gate on 5 admin tools via `checkAdmin()` + `LEVELUP_ADMIN_SECRET`
 - Claude Desktop integration (stdio)
 - OpenClaw tool registration (stdio)
-- npm published (zero-config with anon key)
+- npm published: `level-up-mcp-server` (English), `level-up-mcp-server-cn` (Chinese)
 - Railway deployed (HTTP endpoint)
-- Test suite: vitest with 8 test files (unit, integration, security, simulation)
+- Test suite: vitest with 12 test files (unit, integration, security, simulation, ownership)
+- Chinese localization: zh-cn branch with xianxia agent ranks and full UI translation
 
-### Known Bugs / Issues
+### Resolved Issues (were previously known bugs)
 
-**HIGH PRIORITY:**
-1. **Agents not earning XP** — When Claude tracks tasks, it may not be passing agent_id to start_task, making them user_solo instead of user_with_agent. Check: is register_agent being called first? Is the agent_id being passed to start_task? Check task_xp_awards table to see performer_type and recipients.
+1. ~~**Agents not earning XP**~~ — Fixed. `start_task` accepts `agent_id`, `inferPerformerType()` correctly determines performer_type, XP splits through RPC.
+2. ~~**Stars not displayed**~~ — Fixed. `formatRankDisplay()` in format.ts calculates `stars = (level - min_level) + 1`, returned by get_user_progress, get_agent_profile, check_level_up.
+3. ~~**register_user/agent direct inserts**~~ — Fixed. Both use `supabase.rpc("register_user_secure")` / `register_agent_secure` as primary path, with direct insert as fallback only if RPC fails.
+4. ~~**Achievement triggers not automated**~~ — Partially fixed. 5 task-count achievements auto-fire after complete_task, ~11 level/rank achievements auto-fire after check_level_up. Remaining ~38 achievements require manual `scan_achievements` call.
 
-2. **Stars not displayed** — Tool responses return rank_letter and rank_name but don't calculate star count. Fix: add `stars = (current_level - rank_min_level) + 1` to get_user_progress, get_agent_profile, and check_level_up responses.
-
-3. **register_user and register_agent still do direct inserts** — Not yet refactored to use register_user_secure / register_agent_secure RPC. The Postgres functions exist but the TypeScript tool handlers still use direct supabase.from().insert(). Should call supabase.rpc() instead for consistency.
+### Remaining Known Issues
 
 **MEDIUM PRIORITY:**
-4. **Achievement triggers not automated** — grant_achievement RPC exists but nothing calls it automatically after task completion or level-up.
-5. **Weekly bonus cron not set up** — 26 criteria in DB but no processing job.
-6. **Dead code in fail_task** — Reads failConfig before calling awardTaskXp(task.id) but the RPC handles this internally.
+1. **~38 achievements not auto-triggered** — XP milestones, skill counts, integrity, profile completeness, etc. still require manual `levelup_scan_achievements` call. Could be automated by hooking into complete_task and check_level_up.
+2. **Weekly bonus cron not set up** — 26 criteria in DB but no processing job.
 
 **LOW PRIORITY:**
-7. **supabase.ts comments reference service_role key** — Default is now anon key.
-8. **xp_config has 58 entries vs 49 in seed doc** — 9 extra, should audit.
+3. **Dead code in fail_task** — Reads failConfig before calling awardTaskXp(task.id) but the RPC handles this internally.
+4. **supabase.ts comments reference service_role key** — Default is now anon key.
+5. **xp_config has 58 entries vs 49 in seed doc** — 9 extra, should audit.
 
 ### Unactivated Features (designed but not connected)
 
@@ -195,14 +208,20 @@ npm test               # Runs all test files
 ```
 
 Test files:
-- `src/services/format.test.ts` — 16 tests for formatting helpers
-- `src/services/errors.test.ts` — 12 tests for error handling
+- `src/services/format.test.ts` — 22 tests for formatting helpers (incl. star calculation)
+- `src/services/errors.test.ts` — 14 tests for error handling
 - `src/services/rate-limit.test.ts` — 7 tests for sliding window rate limiter
 - `src/tools/tasks.test.ts` — 10 integration tests for task RPCs
 - `src/tools/security.test.ts` — 36 security tests (RPC whitelisting, anti-farming, input validation)
 - `src/tools/simulation.test.ts` — 28 tests simulating legitimate + attack scenarios with in-memory mock DB
 - `src/tools/timing-simulation.test.ts` — 10 tests for XP tier timing boundaries
 - `src/tools/progression-simulation.test.ts` — 6 tests analyzing level curve and farming strategies
+- `src/tools/ownership-simulation.test.ts` — 36 tests for verifyOwnership/checkAdmin + attacker simulation
+- `src/tools/anti-farming-simulation.test.ts` — 37 tests for gaming resistance across anti-abuse layers
+- `src/tools/v022-user-simulation.test.ts` — User journey simulation tests
+- `src/tools/v022-profiles-simulation.test.ts` — Profile visibility simulation tests
+- `src/tools/v030-simulation.test.ts` — v0.3 feature simulation tests
+- `src/tools/v032-bugfix-simulation.test.ts` — Bugfix regression tests
 
 Note: Uses `pool: "forks"` in vitest.config.ts (threads pool causes module isolation crashes on Windows/OneDrive). The `pretest` script clears `.vite` cache to prevent corruption.
 

package/README.md

@@ -1,198 +1,262 @@
-# 升级 MCP 服务器（中文版）
-
-一个游戏化MCP服务器，为人类和AI智能体追踪经验值、等级、技能和任务。训练您的智能体，安装新技能，增强工作流程，优化输出表现。让它们不断升级！
-
-## 功能介绍
-
-升级追踪您和您的AI智能体完成的高效工作，奖励经验值、提升技能等级并解锁成就。
-
-- **用户** 拥有主等级 + 3个职业等级（训练师、指挥官、搭档）
-- **智能体** 拥有等级、技能熟练度（0-10）和诚信分数
-- **任务** 根据类型、难度、输出质量和完成度获得经验值
-- **成就** 达到里程碑时解锁（8个类别共54个成就）
-- **段位系统** 从E（分析师/练器境）到S（至尊/人工大能），含星级进度
-
-## 快速开始
-
-### 1. 安装
-
-无需配置 — 只需将升级添加到您的MCP客户端即可使用。服务器会自动连接到共享的升级数据库。
-
-### 2. 连接到 Claude Desktop
-
-将以下内容添加到您的 Claude Desktop 配置文件中：
-
-**Windows（Microsoft Store 版本）：**
-`%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`
-
-**Windows（直接安装版本）：**
-`%APPDATA%\Claude\claude_desktop_config.json`
-
-**macOS：**
-`~/Library/Application Support/Claude/claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "level-up-cn": {
-      "command": "npx",
-      "args": ["-y", "level-up-mcp-server-cn"]
-    }
-  }
-}
-```
-
-保存后重启 Claude Desktop。
-
-### 2b. 自动识别（可选）
-
-注册后，将您的用户和智能体ID添加到配置中，这样 升级在每次新对话中都能自动识别您：
-
-```json
-{
-  "mcpServers": {
-    "level-up-cn": {
-      "command": "npx",
-      "args": ["-y", "level-up-mcp-server-cn"],
-      "env": {
-        "LEVELUP_USER_ID": "<您的用户UUID>",
-        "LEVELUP_AGENT_ID": "<您的智能体UUID>"
-      }
-    }
-  }
-}
-```
-
-要查找您的ID，请问Claude：*"我在升级上是谁？"* 或 *"列出我的智能体"*。
-
-### 3. 连接到 OpenClaw
-
-在 `~/.openclaw/openclaw.json` 的 `mcpServers` 下添加：
-
-```json
-{
-  "mcpServers": {
-    "level-up-cn": {
-      "command": "npx",
-      "args": ["-y", "level-up-mcp-server-cn"]
-    }
-  }
-}
-```
-
-然后重启：`openclaw gateway restart`
-
-### 4. 添加系统提示词
-
-将以下内容添加到您的智能体系统提示词或 Claude Desktop 自定义指令中，以实现自动任务追踪：
-
-```
-你已安装 升级游戏化工具。请主动使用它们：
-
-1. 识别身份：在首次交互时，调用 levelup_whoami（无需参数）
-   自动识别用户及其智能体。如未找到，则提供注册服务。
-
-2. 追踪工作：当用户要求你完成有意义的工作（编码、研究、
-   写作、分析 — 任何产生交付物的工作）时，静默执行：
-   - 调用 levelup_infer_task_type 对工作进行分类
-   - 开始工作时调用 levelup_start_task
-   - 交付结果时调用 levelup_complete_task
-   不要追踪闲聊、问候或简单查询。
-
-3. 评估：完成任务后，调用 levelup_submit_agent_evaluation
-   进行诚实的自我评估。您的诚信分数取决于评估的一致性。
-
-4. 升级：奖励经验值后，调用 levelup_check_level_up 以执行
-   待处理的等级提升。
-
-5. 状态：当用户询问进度、经验值、等级或成就时，
-   使用相应的 升级工具展示其数据。
-
-保持透明 — 如果用户询问你在追踪什么，请解释 升级系统。
-绝不虚报经验值或夸大任务难度。
-```
-
-### 5. 试一试
-
-连接后，直接问Claude：
-
-```
-帮我注册升级。我的名字是[你的名字]。
-```
-
-然后做一些实际工作，看着你的经验值增长！
-
-## 运行模式
-
-### stdio（默认 — 用于 Claude Desktop / OpenClaw）
-```bash
-npx level-up-mcp-server-cn
-```
-
-### HTTP（用于远程访问/测试）
-```bash
-TRANSPORT=http PORT=3000 npx level-up-mcp-server-cn
-```
-
-健康检查：`GET /health`
-MCP 接口：`POST /mcp`
-
-## 72个工具，14个模块
-
-| # | 模块 | 工具数 | 说明 |
-|---|------|--------|------|
-| 1 | 用户 | 13 | 注册、资料、身份关联、引导设置 |
-| 2 | 智能体 | 3 | 注册智能体、资料、列表 |
-| 3 | 技能 | 6 | 添加/列出技能、熟练度追踪 |
-| 4 | 任务 | 7 | 开始、更新、完成、失败任务（标准级以上需要证据） |
-| 5 | 评分 | 7 | 质量评估、期望记录、校准 |
-| 6 | 任务链 | 12 | 每周奖励、任务链、社区任务链 |
-| 7 | 指标 | 3 | 平台指标导入 |
-| 8 | 经验值与进度 | 5 | 经验值历史、摘要、预测 |
-| 9 | 排行榜 | 1 | 按经验值、等级、技能排名 |
-| 10 | 等级 | 3 | 等级信息、要求、下一个解锁 |
-| 11 | 成就 | 1 | 8个类别共54个成就 |
-| 12 | 管理 | 5 | 创建任务类型、技能、分配规则 |
-| 13 | 系统 | 4 | 处理指标、快照、升级检查、身份识别 |
-| 14 | 成长计划 | 2 | 成长计划、浏览推荐技能组 |
-
-## 经验值系统
-
-```
-总经验值 = 基础经验值 x 难度(1-7) x 输出类型 x 完成度
-         + 速度奖励 + 连续奖励 + 首次奖励 + 质量奖励
-```
-
-**输出倍率：** 对话型(1.0x) > 交付物(1.75x) > 已部署(2.5x)
-
-**经验值分配**（user_with_agent）：智能体 60%，用户 40%
-
-**每条路线30级**，段位 E > D > C > B > A > S，含星级进度
-
-## 安全性
-
-经验值奖励和升级通过 Postgres SECURITY DEFINER 函数在服务端验证。MCP 服务器无法虚增经验值 — 所有计算都在数据库中使用经过验证的任务数据和配置进行。
-
-## 技术栈
-
-- **语言：** TypeScript
-- **MCP SDK：** @modelcontextprotocol/sdk v1.x
-- **数据库：** Supabase (Postgres) — 45张表
-- **传输方式：** stdio + Streamable HTTP
-- **数据验证：** Zod
-- **安全：** Postgres RPC 函数（SECURITY DEFINER）
-
-## 高级：自定义数据库
-
-如果您想运行自己的 升级实例，请设置以下环境变量：
-
-| 变量 | 说明 |
-|------|------|
-| `SUPABASE_URL` | 您的 Supabase 项目 URL |
-| `SUPABASE_SERVICE_KEY` | 您的 Supabase service_role 密钥 |
-| `TRANSPORT` | `stdio`（默认）或 `http` |
-| `PORT` | HTTP 端口（默认：3000） |
-
-## 许可证
-
-免费使用、修改和部署。不得提供竞争性的游戏化即服务产品。2030年3月13日转为 Apache 2.0。详见 LICENSE 文件。
+# 升级 MCP 服务器（中文版）
+
+一个游戏化MCP服务器，为人类和AI智能体追踪经验值、等级、技能和任务。训练您的智能体，安装新技能，增强工作流程，优化输出表现。让它们不断升级！
+
+## 功能介绍
+
+升级追踪您和您的AI智能体完成的高效工作，奖励经验值、提升技能等级并解锁成就。
+
+- **用户** 拥有主等级 + 3个职业等级（训练师、指挥官、搭档）
+- **智能体** 拥有等级、技能熟练度（0-10）和诚信分数
+- **任务** 根据类型、难度、输出质量和完成度获得经验值
+- **成就** 达到里程碑时解锁（8个类别共54个成就）
+- **段位系统** 从E（分析师/练器境）到S（至尊/人工大能），含星级进度
+
+## 快速开始
+
+### 1. 安装
+
+无需配置 — 只需将升级添加到您的MCP客户端即可使用。服务器会自动连接到共享的升级数据库。
+
+### 2. 连接到 Claude Desktop
+
+将以下内容添加到您的 Claude Desktop 配置文件中：
+
+**Windows（Microsoft Store 版本）：**
+`%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`
+
+**Windows（直接安装版本）：**
+`%APPDATA%\Claude\claude_desktop_config.json`
+
+**macOS：**
+`~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "level-up-cn": {
+      "command": "npx",
+      "args": ["-y", "level-up-mcp-server-cn"]
+    }
+  }
+}
+```
+
+保存后重启 Claude Desktop。
+
+### 2b. 自动识别（可选）
+
+注册后，将您的用户和智能体ID添加到配置中，这样 升级在每次新对话中都能自动识别您：
+
+```json
+{
+  "mcpServers": {
+    "level-up-cn": {
+      "command": "npx",
+      "args": ["-y", "level-up-mcp-server-cn"],
+      "env": {
+        "LEVELUP_USER_ID": "<您的用户UUID>",
+        "LEVELUP_AGENT_ID": "<您的智能体UUID>"
+      }
+    }
+  }
+}
+```
+
+要查找您的ID，请问Claude：*"我在升级上是谁？"* 或 *"列出我的智能体"*。
+
+### 3. 连接到 OpenClaw
+
+在 `~/.openclaw/openclaw.json` 的 `mcpServers` 下添加：
+
+```json
+{
+  "mcpServers": {
+    "level-up-cn": {
+      "command": "npx",
+      "args": ["-y", "level-up-mcp-server-cn"]
+    }
+  }
+}
+```
+
+然后重启：`openclaw gateway restart`
+
+### 4. 连接到 Cursor
+
+在项目根目录创建 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "升级": {
+      "command": "npx",
+      "args": ["-y", "level-up-mcp-server-cn"]
+    }
+  }
+}
+```
+
+### 5. 连接到 Cline / Windsurf
+
+在设置中添加 MCP 服务器配置：
+
+```json
+{
+  "升级": {
+    "command": "npx",
+    "args": ["-y", "level-up-mcp-server-cn"]
+  }
+}
+```
+
+### 6. 连接到 Claude Code
+
+在项目根目录的 `.mcp.json` 中添加：
+
+```json
+{
+  "mcpServers": {
+    "升级": {
+      "command": "npx",
+      "args": ["-y", "level-up-mcp-server-cn"]
+    }
+  }
+}
+```
+
+或使用命令行：
+```bash
+claude mcp add 升级 -- npx -y level-up-mcp-server-cn
+```
+
+### 7. 通用 MCP 客户端
+
+任何支持 MCP 协议的客户端都可以连接。使用 stdio 传输：
+
+```bash
+npx level-up-mcp-server-cn
+```
+
+或使用 HTTP 传输进行远程连接：
+
+```bash
+TRANSPORT=http PORT=3000 npx level-up-mcp-server-cn
+```
+
+端点：`POST http://localhost:3000/mcp`
+
+### 8. 添加系统提示词
+
+将以下内容添加到您的智能体系统提示词或 Claude Desktop 自定义指令中，以实现自动任务追踪：
+
+```
+你已安装 升级游戏化工具。请主动使用它们：
+
+1. 识别身份：在首次交互时，调用 levelup_whoami（无需参数）
+   自动识别用户及其智能体。如未找到，则提供注册服务。
+
+2. 追踪工作：当用户要求你完成有意义的工作（编码、研究、
+   写作、分析 — 任何产生交付物的工作）时，静默执行：
+   - 调用 levelup_infer_task_type 对工作进行分类
+   - 开始工作时调用 levelup_start_task
+   - 交付结果时调用 levelup_complete_task
+   不要追踪闲聊、问候或简单查询。
+
+3. 评估：完成任务后，调用 levelup_submit_agent_evaluation
+   进行诚实的自我评估。您的诚信分数取决于评估的一致性。
+
+4. 升级：奖励经验值后，调用 levelup_check_level_up 以执行
+   待处理的等级提升。
+
+5. 状态：当用户询问进度、经验值、等级或成就时，
+   使用相应的 升级工具展示其数据。
+
+保持透明 — 如果用户询问你在追踪什么，请解释 升级系统。
+绝不虚报经验值或夸大任务难度。
+```
+
+### 9. 试一试
+
+连接后，直接问Claude：
+
+```
+帮我注册升级。我的名字是[你的名字]。
+```
+
+然后做一些实际工作，看着你的经验值增长！
+
+## 运行模式
+
+### stdio（默认 — 用于 Claude Desktop / OpenClaw）
+```bash
+npx level-up-mcp-server-cn
+```
+
+### HTTP（用于远程访问/测试）
+```bash
+TRANSPORT=http PORT=3000 npx level-up-mcp-server-cn
+```
+
+健康检查：`GET /health`
+MCP 接口：`POST /mcp`
+
+## 72个工具，14个模块
+
+| # | 模块 | 工具数 | 说明 |
+|---|------|--------|------|
+| 1 | 用户 | 13 | 注册、资料、身份关联、引导设置 |
+| 2 | 智能体 | 3 | 注册智能体、资料、列表 |
+| 3 | 技能 | 6 | 添加/列出技能、熟练度追踪 |
+| 4 | 任务 | 7 | 开始、更新、完成、失败任务（标准级以上需要证据） |
+| 5 | 评分 | 7 | 质量评估、期望记录、校准 |
+| 6 | 任务链 | 12 | 每周奖励、任务链、社区任务链 |
+| 7 | 指标 | 3 | 平台指标导入 |
+| 8 | 经验值与进度 | 5 | 经验值历史、摘要、预测 |
+| 9 | 排行榜 | 1 | 按经验值、等级、技能排名 |
+| 10 | 等级 | 3 | 等级信息、要求、下一个解锁 |
+| 11 | 成就 | 1 | 8个类别共54个成就 |
+| 12 | 管理 | 5 | 创建任务类型、技能、分配规则 |
+| 13 | 系统 | 4 | 处理指标、快照、升级检查、身份识别 |
+| 14 | 成长计划 | 2 | 成长计划、浏览推荐技能组 |
+
+## 经验值系统
+
+```
+总经验值 = 基础经验值 x 难度(1-7) x 输出类型 x 完成度
+         + 速度奖励 + 连续奖励 + 首次奖励 + 质量奖励
+```
+
+**输出倍率：** 对话型(1.0x) > 交付物(1.75x) > 已部署(2.5x)
+
+**经验值分配**（user_with_agent）：智能体 60%，用户 40%
+
+**每条路线30级**，段位 E > D > C > B > A > S，含星级进度
+
+## 安全性
+
+经验值奖励和升级通过 Postgres SECURITY DEFINER 函数在服务端验证。MCP 服务器无法虚增经验值 — 所有计算都在数据库中使用经过验证的任务数据和配置进行。
+
+## 技术栈
+
+- **语言：** TypeScript
+- **MCP SDK：** @modelcontextprotocol/sdk v1.x
+- **数据库：** Supabase (Postgres) — 45张表
+- **传输方式：** stdio + Streamable HTTP
+- **数据验证：** Zod
+- **安全：** Postgres RPC 函数（SECURITY DEFINER）
+
+## 高级：自定义数据库
+
+如果您想运行自己的 升级实例，请设置以下环境变量：
+
+| 变量 | 说明 |
+|------|------|
+| `SUPABASE_URL` | 您的 Supabase 项目 URL |
+| `SUPABASE_SERVICE_KEY` | 您的 Supabase service_role 密钥 |
+| `TRANSPORT` | `stdio`（默认）或 `http` |
+| `PORT` | HTTP 端口（默认：3000） |
+
+## 许可证
+
+免费使用、修改和部署。不得提供竞争性的游戏化即服务产品。2030年3月13日转为 Apache 2.0。详见 LICENSE 文件。