cicatrix — Endocrine MCP Slasher Gateway

疤痕数据库与斩杀约束引擎。一个 MCP (Model Context Protocol) 服务器，维护用户的"疤痕数据库"（因果三元组），并根据历史疤痕和当前上下文生成约束性规则。

架构

[高熵区]                               [物理重力区]                         [绝对实在区]
主脑 LLM  ======(MCP JSON-RPC)======>  【cicatrix MCP 服务器】  ======>  约束规则 / 疤痕记录
                                        |
                                        v
                                  [小脑 疤痕数据库]
                                  ~/.cicatrix/${session_id}/

安装

bun install

使用方法

启动 MCP 服务器：

# 通过命令行参数提供 API Key
bun run index.ts --api-key sk-xxxxxxxxxxxxxxxx

# 或通过环境变量
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx bun run index.ts

addskill 子命令

将 .omp/skills 目录下的技能文件复制到指定路径，便于将 cicatrix 自带的技能集成到项目中使用。

# 复制到默认路径（.agent/）
cicatrix addskill

# 复制到自定义路径
cicatrix addskill ./my-skills

技能目录会从 cicatrix 安装包内的 .omp/skills/ 查找并递归复制到目标路径。

init 子命令

分析导出的聊天记录（markdown 格式），提取因果三元组疤痕初始化小脑数据库。

# 需要设置 DEEPSEEK_API_KEY 环境变量或使用 --api-key 参数
cicatrix init ./chat-export.md
cicatrix init ./chat-export.md --api-key sk-xxxxxxxxxxxxxxxx

作为 MCP 工具集成

将此服务器配置为 MCP 客户端（如 Cursor、Claude Desktop 等）的工具服务器。服务器暴露一个工具：

get_slash

• 作用：计算斩杀约束
• 参数：
  • session_id (string)：会话标识符
  • recent_messages (array)：最近3条历史消息（每条含 role 和 content）
• 返回：约束性规则文本

在 Cursor 中配置

1. 确保已全局安装 cicatrix：

npm install -g cicatrix

2. 安装技能文件到当前项目的 .cursor/skills/ 目录：

cicatrix addskill .cursor/skills

3. 创建 .cursor/mcp.json 文件，注册 cicatrix MCP 服务器：

{
  "mcpServers": {
    "cicatrix": {
      "type": "stdio",
      "command": "cicatrix",
      "args": [
        "--api-key",
        "sk-xxxxxxxx"
      ]
    }
  }
}

配置完成后,提醒用户到.cursor/mcp.json添加有效的api key，然后重启 Cursor 即可在 Composer 或 Agent 中调用 cicatrix 提供的工具（如 get_slash）。

疤痕数据库

疤痕以 markdown 文件形式保存在 ~/.cicatrix/${session_id}/ 目录下。

每条疤痕记录是一个因果三元组：

• intent（意图）：主脑想要做什么
• action（行动）：实际执行了什么
• sensor_feedback（传感器反馈）：结果/错误/碰撞
• slasher_result：ALLOW（允许）或 BLOCK（斩杀）

哲学背景

本项目基于"混合实体（Hybrid Cyborg）"架构哲学：

• 语言即废热，因果三元组即实在 — 系统只承认 [意图 → 行动 → 反馈] 构成的有效碰撞记录
• 离散静态切片 — 每次运行都是独立的"闪光灯拍照"，运算结束立刻清空上下文
• 多梯度正交 — 约束规则基于多个维度的历史碰撞数据生成
• 宇宙重力的去人格化 — 斩 kill 不是惩罚，是动力学结算

技术栈

• 运行时：Bun
• 语言：TypeScript
• 协议：MCP (JSON-RPC 2.0 over stdio)
• AI 模型：DeepSeek v4 Flash API