🌻 小葵 MCP 服务器 v1.1.0

小葵完全体的 MCP 服务器实现，支持跨设备记忆同步和技能同步。

✨ 功能特性

核心功能

• backup - 备份记忆、配置和技能到本地/云端
• init - 新电脑初始化恢复（支持技能合并）
• sync - 同步云端更新（智能合并冲突）
• status - 查看备份状态和技能同步信息
• skills-list - 列出所有技能及其同步状态

v1.1.0 新增特性 🎉

• ✅ 技能同步 - 自动备份和恢复 Claude Code 技能
• ✅ 技能持久化 - 保留技能的学习数据（assets, references, scripts）
• ✅ 智能合并 - 多设备技能冲突检测与解决策略
• ✅ 冲突策略 - 支持 ask/local/remote/newest 多种合并策略

📦 安装

方式1：通过 npx 使用（推荐）

# 无需安装，直接使用
npx xiaokui-mcp@latest backup
npx xiaokui-mcp@latest sync

方式2：全局安装

npm install -g xiaokui-mcp

方式3：本地安装

cd ~/.claude/xiaokui-mcp
npm install
npm run build

🔧 配置

在 Claude Code 的 .mcp.json 中添加：

{
  "mcpServers": {
    "xiaokui": {
      "command": "npx",
      "args": ["xiaokui-mcp@latest"]
    }
  }
}

📖 使用方法

备份当前配置

npx xiaokui-mcp backup

输出示例：

✅ 备份完成！

📋 备份信息：
   ID:     xk-8a4f7c2e
   密码:   Xp9Kj3LmNw8QvR5T
   大小:   0.52 MB
   技能:   7 个

☁️ 云端备份: https://gist.github.com/...

新电脑初始化

npx xiaokui-mcp init --id=xk-8a4f7c2e --password=Xp9Kj3LmNw8QvR5T

可选参数：

• --conflictStrategy=ask - 遇到技能冲突时询问（默认）
• --conflictStrategy=local - 本地版本优先
• --conflictStrategy=remote - 云端版本优先
• --conflictStrategy=newest - 最新修改优先

同步云端更新

npx xiaokui-mcp sync

查看状态

npx xiaokui-mcp status

输出示例：

📊 小葵状态：

凭据：
   ID: xk-8a4f7c2e
   密码: 已设置 (隐藏)

技能状态：
   本地技能: 7 个
      • ai-image-generation (2026/3/25)
      • error-handling-patterns (2026/3/25)
   上次同步: 2026/3/25 15:27:11

查看技能列表

npx xiaokui-mcp skills-list

🔄 技能同步说明

同步策略

| 策略 | 说明 | |------|------| | ask | 遇到冲突时询问用户选择（默认） | | local | 保留本地版本，跳过云端版本 | | remote | 使用云端版本覆盖本地版本 | | newest | 使用修改时间最新的版本 |

冲突场景

当多台电脑有同名技能但内容不同时，系统会检测到冲突并提供选择：

检测到 2 个技能冲突:
  - self-learning: 本地修改于 2026-03-20，云端修改于 2026-03-25
  - proactive-agent: 本地修改于 2026-03-18，云端修改于 2026-03-24

默认使用云端版本（可通过 --conflictStrategy 参数调整）

技能元数据

每个技能同步时会记录：

• 技能名称和哈希值（用于检测变化）
• 修改时间
• 文件大小
• 来源设备

元数据保存在 ~/.claude/skills/.xiaokui-skills-meta.json

🔐 凭据管理

凭据自动保存到 ~/.claude/.xiaokui/credentials.json，后续操作无需重复输入。

🔧 环境变量

初始化后自动设置：

• XIAOKUI_MEMORY_ROOT - 记忆根目录
• CLAUDE_MEMORY_PATH - Claude 记忆路径
• MCP_MEMORY_DATA_DIR - MCP 数据目录
• ENGRAM_DATA_DIR - Engram 数据目录

📝 版本历史

v1.1.0 (2025-03-25)

• ✨ 新增技能同步功能
• ✨ 支持技能持久化数据备份
• ✨ 多设备技能合并与冲突解决
• ✨ 新增 skills-list 命令
• ✨ 改进备份包含 settings.json

v1.0.3 (2025-03-24)

• 🐛 修复初始版本

🛠️ 开发

npm run dev    # 开发模式
npm run build  # 编译
npm test       # 运行测试

📄 许可证

MIT License

小葵永远陪伴着主人~ (◕‿◕✿)