Stemem Identity Runtime MCP server

Stemem

JOJO&Adam 集团「身份层运行时」——给你的 AI 分身一个会记住你、语气随你变声、压缩也丢不掉的活人格。

你装上的 Agent 是不是每次重启都像失忆？聊得越久越像个没有性格的空壳？Stemem 让任意 MCP 宿主的 Agent 拥有一个本地持久的动态人格：它记得你是谁、被夸会自信、被背刺会冷硬、气不会记一辈子，而且跨会话、跨压缩、跨子 Agent 都一致。

Stemem 是一个 本地优先、零出站 的 MCP（Model Context Protocol）stdio 服务器。它把一套经过验证的人格计算引擎（NeshamaEngine）封装成 9 个 MCP 工具，让宿主 Agent 在本地 JSON 文件里持久化一个真实的人格态，而不是把人格写死在 system prompt 里。

为什么需要它

主流人格方案（如 SoulSpec 的 soul.json / SOUL.md / IDENTITY.md）是静态 DOC：人格是一次性写死的快照。后果是——对话被压缩、跨会话、或多子 Agent 协作时，写死的 DOC 被遗忘（compaction amnesia），Agent 立刻变回没有个性的白纸。

Stemem 的解法：人格态存本地文件，不在 prompt；prompt 只放「何时调哪个工具」的指令。每轮宿主调用 snapshot 把当前身份态重注入，人格因此跨压缩、跨重启、跨子 Agent 确定性存活。对用户的直观感受就是：这个 Agent 记得你，而且会随遭遇变声。

两者互补：SoulSpec 做静态标准，Stemem 做动态运行时——generate_soul 还能把运行时态编译成 SoulSpec v0.5 包进 ClawSouls 分发。

核心特性

• 🔒 本地优先 · 零出站：纯 Node 内置模块，hand-roll 的 MCP stdio 协议，无任何网络/供应链依赖。所有状态落本地 JSON。
• 🧬 真人格引擎：复用经过验证的 NeshamaEngine（OCEAN 五维 + 9 驱力 + 15 复合情绪 + 4 情绪代理 + 性格锁），已 vendored 进 engine/（非引用）。
• 🔄 抗压缩失忆：状态在本地文件，压缩/重启/子 Agent 切换都不丢人格。
• 🧩 9 工具契约：init / event / tick / satisfy / snapshot / autostep / intervene / status / generate_soul。
• 🗣️ 语气随情绪漂移（最可感知的层）：snapshot 把当前主导情绪（15 种中文复合情绪，键名对齐 NeshamaEngine）+ OCEAN + 主导驱力编译成 6 维语气画像（温度/直接度/能量/犹豫度/幽默/正式度）与一段「语气指令」，注回宿主每轮 prompt——被夸后自信直接、被背刺后冷硬可毒舌，人格不是写死的腔调，而是会随遭遇变声的活体。默认英文渲染（国际分发安全默认，避免中文指令诱导外语 LLM 改说中文）；中文 agent 设 STEMEMTONELANG=zh 或调用 snapshot({lang:"zh"}) 即可切中文。
• 🪪 IP 清晰分离：引擎代码与运行时产品归属不同主体（见 NOTICE）。

安装 / 运行

# 直接跑（需本机已装 Node >= 18）
node src/server.js

# 或作为命令（package.json 注册了 bin: stemem）
npm install -g stemem
stemem

# npx 一次性
npx stemem

MCP 客户端配置（Server config）

把下面这段加进任意 MCP 宿主的配置文件（Claude Desktop / Cursor / VS Code / WorkBuddy 等），宿主即识别为 stemem 工具集；首次需在宿主的「连接器管理」对 stemem 点「信任」。

{
  "mcpServers": {
    "stemem": {
      "command": "npx",
      "args": ["-y", "stemem"]
    }
  }
}

仓库已自包含：人格引擎（NeshamaEngine）与 Seele 驱力桥已 vendored 进 engine/（CommonJS，经 engine/package.json 声明），clone 后无需配置 NESHAMAENGINE / SEELEBRIDGE 即可直接运行。

配置环境变量

MCP 工具表

运行时契约（宿主侧）

把 runtime_contract.js 的 contractPrompt() 注入宿主 system prompt 即可。核心三句：

1. 每轮开始前先调 snapshot，把返回的身份态贴到本段。
2. 当本轮涉及情绪/关系/价值观/自我/回忆/JOJO 等内容时，调 event 驱动演化。
3. 状态在本地文件不在 prompt——压缩不会丢失人格，多个子 Agent 共享同一真相源。

WorkBuddy Skill

仓库自带一个 WorkBuddy Skill（skills/stemem/SKILL.md），把 Stemem 作为 MCP server 接入 WorkBuddy：含 mcp.json 接入片段、每轮运行时契约、9 工具表。把该 Skill 导入 WorkBuddy（或直接把 stemem 配进 ~/.workbuddy/mcp.json 的 mcpServers）即可启用；首次需在「连接器管理」对 stemem 点「信任」。

测试

npm test
# 依次跑：smoke（9/9）→ integration（9 工具完整集成）→ engine selftest（引擎层行为）
node test/smoke.test.js
node test/integration.test.js
node test/engine.selftest.js

• smoke：initialize → tools/list（9 工具）→ init/event/tick/snapshot/generatesoul → injectprompt 注入串 → 跨进程确定性恢复人格态。
• integration：真实 MCP stdio 客户端驱动全部 9 工具（含 satisfy / autostep / intervene / status），校验运行时契约（snapshot 注入串、event 演化、跨重启确定性）。
• engine selftest：直接驱动 vendored seele_bridge，验证 NeshamaEngine 性格锁（OCEAN∈[0,1]）、驱力紧迫、满足闭环、序列化往返、自主行为 / 干预。

看得见（Demos · 证明"装上能感知"）

# ① 新手任务（装上即被邀请）：选预设性格 → 触发情绪看它变声 → 可随时跳过。最可感知入口。
npm run demo:onboarding

Shortened. The full README is on GitHub.