level-up-mcp-server-cn 0.4.0

package/README.md

@@ -0,0 +1,198 @@
+# 升级 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 文件。

package/dist/constants.d.ts

@@ -0,0 +1,33 @@
+/** Maximum characters in a single tool response (prevents overwhelming the LLM) */
+export declare const CHARACTER_LIMIT = 25000;
+/** Default number of items returned in paginated lists */
+export declare const DEFAULT_PAGE_SIZE = 20;
+/** Maximum items a single page can return */
+export declare const MAX_PAGE_SIZE = 100;
+/** Server metadata — used when registering with the MCP protocol */
+export declare const SERVER_NAME = "level-up-mcp-server-cn";
+export declare const SERVER_VERSION = "0.1.0";
+/**
+ * Tool name prefix — every tool starts with "levelup_"
+ * This avoids naming collisions when Level-Up runs alongside
+ * other MCP servers (like GitHub, Slack, etc.)
+ */
+export declare const TOOL_PREFIX = "levelup_";
+/**
+ * Valid performer types for tasks.
+ * "agent_solo" means the AI did it alone, "user_with_agent" means collaboration, etc.
+ */
+export declare const PERFORMER_TYPES: readonly ["agent_solo", "user_solo", "user_with_tools", "user_with_agent", "orchestrated"];
+/** Valid task statuses */
+export declare const TASK_STATUSES: readonly ["in_progress", "completed", "failed", "cancelled"];
+/** Valid output types — affects XP multiplier */
+export declare const OUTPUT_TYPES: readonly ["conversational", "deliverable", "deployed"];
+/** Identity providers for multi-platform auth */
+export declare const IDENTITY_PROVIDERS: readonly ["email", "telegram", "whatsapp", "wechat", "google", "github", "wallet", "custom"];
+/** User class names — each user has 3 class tracks */
+export declare const USER_CLASSES: readonly ["trainer", "orchestrator", "partner"];
+/** Agent platforms */
+export declare const AGENT_PLATFORMS: readonly ["openclaw", "claude", "custom"];
+/** XP base tiers */
+export declare const XP_TIERS: readonly ["micro", "light", "standard", "complex", "major"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -0,0 +1,78 @@
+// ============================================================
+// constants.ts — Shared values used across the entire server
+// ============================================================
+// Think of this as your "settings" file. Instead of scattering
+// magic numbers throughout the code, we define them once here.
+// If you need to change a limit, you change it in ONE place.
+// ============================================================
+/** Maximum characters in a single tool response (prevents overwhelming the LLM) */
+export const CHARACTER_LIMIT = 25_000;
+/** Default number of items returned in paginated lists */
+export const DEFAULT_PAGE_SIZE = 20;
+/** Maximum items a single page can return */
+export const MAX_PAGE_SIZE = 100;
+/** Server metadata — used when registering with the MCP protocol */
+export const SERVER_NAME = "level-up-mcp-server-cn";
+export const SERVER_VERSION = "0.1.0";
+/**
+ * Tool name prefix — every tool starts with "levelup_"
+ * This avoids naming collisions when Level-Up runs alongside
+ * other MCP servers (like GitHub, Slack, etc.)
+ */
+export const TOOL_PREFIX = "levelup_";
+/**
+ * Valid performer types for tasks.
+ * "agent_solo" means the AI did it alone, "user_with_agent" means collaboration, etc.
+ */
+export const PERFORMER_TYPES = [
+    "agent_solo",
+    "user_solo",
+    "user_with_tools",
+    "user_with_agent",
+    "orchestrated",
+];
+/** Valid task statuses */
+export const TASK_STATUSES = [
+    "in_progress",
+    "completed",
+    "failed",
+    "cancelled",
+];
+/** Valid output types — affects XP multiplier */
+export const OUTPUT_TYPES = [
+    "conversational",
+    "deliverable",
+    "deployed",
+];
+/** Identity providers for multi-platform auth */
+export const IDENTITY_PROVIDERS = [
+    "email",
+    "telegram",
+    "whatsapp",
+    "wechat",
+    "google",
+    "github",
+    "wallet",
+    "custom",
+];
+/** User class names — each user has 3 class tracks */
+export const USER_CLASSES = [
+    "trainer",
+    "orchestrator",
+    "partner",
+];
+/** Agent platforms */
+export const AGENT_PLATFORMS = [
+    "openclaw",
+    "claude",
+    "custom",
+];
+/** XP base tiers */
+export const XP_TIERS = [
+    "micro",
+    "light",
+    "standard",
+    "complex",
+    "major",
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6DAA6D;AAC7D,+DAA+D;AAC/D,+DAA+D;AAC/D,+DAA+D;AAC/D,6DAA6D;AAC7D,+DAA+D;AAE/D,mFAAmF;AACnF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,wBAAwB,CAAC;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,WAAW;IACX,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;CACN,CAAC;AAEX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,aAAa;IACb,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAEX,iDAAiD;AACjD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gBAAgB;IAChB,aAAa;IACb,UAAU;CACF,CAAC;AAEX,iDAAiD;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,UAAU;IACV,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS;IACT,cAAc;IACd,SAAS;CACD,CAAC;AAEX,sBAAsB;AACtB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU;IACV,QAAQ;IACR,QAAQ;CACA,CAAC;AAEX,oBAAoB;AACpB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO;IACP,OAAO;IACP,UAAU;IACV,SAAS;IACT,OAAO;CACC,CAAC"}

package/dist/data/quest-seeds.d.ts

@@ -0,0 +1,18 @@
+export interface QuestSeed {
+    title: string;
+    description: string;
+    quest_type: "default" | "recurring" | "one_off";
+    target_type: "user" | "agent" | "both";
+    category: "onboarding" | "skill" | "automation" | "weekly" | "achievement" | "exploration";
+    base_xp_reward: number;
+    requirements: {
+        type: string;
+        target: number;
+        filter?: Record<string, unknown>;
+    };
+    min_user_level?: number;
+    safe_for_autonomous: boolean;
+    order?: number;
+}
+export declare const QUEST_SEEDS: QuestSeed[];
+//# sourceMappingURL=quest-seeds.d.ts.map