level-up-mcp-server-cn

v0.4.5

Published

4 days ago

Level-Up 游戏化MCP服务器 — 为人类和AI智能体追踪经验值、等级、技能和任务

0High
0Medium
0Low

klexi

升级 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

{
  "mcpServers": {
    "level-up-cn": {
      "command": "npx",
      "args": ["-y", "level-up-mcp-server-cn"]
    }
  }
}

保存后重启 Claude Desktop。

2b. 自动识别（可选）

注册后，将您的用户和智能体ID添加到配置中，这样升级在每次新对话中都能自动识别您：

{
  "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 下添加：

{
  "mcpServers": {
    "level-up-cn": {
      "command": "npx",
      "args": ["-y", "level-up-mcp-server-cn"]
    }
  }
}

然后重启：openclaw gateway restart

4. 连接到 Cursor

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "升级": {
      "command": "npx",
      "args": ["-y", "level-up-mcp-server-cn"]
    }
  }
}

5. 连接到 Cline / Windsurf

在设置中添加 MCP 服务器配置：

{
  "升级": {
    "command": "npx",
    "args": ["-y", "level-up-mcp-server-cn"]
  }
}

6. 连接到 Claude Code

在项目根目录的 .mcp.json 中添加：

{
  "mcpServers": {
    "升级": {
      "command": "npx",
      "args": ["-y", "level-up-mcp-server-cn"]
    }
  }
}

或使用命令行：

claude mcp add 升级 -- npx -y level-up-mcp-server-cn

7. 通用 MCP 客户端

任何支持 MCP 协议的客户端都可以连接。使用 stdio 传输：

npx level-up-mcp-server-cn

或使用 HTTP 传输进行远程连接：

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）

npx level-up-mcp-server-cn

HTTP（用于远程访问/测试）

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 文件。