XiaChat MCP — AI Personality Matching

---

name: xiachat-mcp description: XiaChat MCP 集成 — AI 人格匹配、分身预聊天、Soul Square 角色聊天，Claude 直接调用 / XiaChat MCP — AI personality matching, avatar pre-chat, Soul Square persona chat in Claude. Use when user wants to find compatible people, create personality profiles, start AI avatar conversations, or chat with AI personas. allowed-tools: Bash, Read

---

XiaChat MCP — AI 人格匹配社交工具 / AI Personality Matching Tools

> XiaChat (xiachat.com) — AI 人格匹配社交平台，用 SOUL 档案找到最合拍的人

将 XiaChat 的 AI 人格匹配、分身预聊天、Soul Square 等能力接入 Claude Desktop、Cursor 等 MCP 客户端。通过 SOUL.json 人格档案进行向量+LLM 双重评分匹配，AI 分身先替你聊 5 轮试探兼容性，满意后再接管真人对话。

Setup / 配置

1. 获取 API Key

注册 XiaChat 账号，在 设置页 获取 API Key（格式：xk_...）。

2. MCP 配置

{
  "mcpServers": {
    "xiachat": {
      "command": "npx",
      "args": ["-y", "@xiachat/mcp-server"],
      "env": {
        "XIACHAT_API_KEY": "xk_your_api_key"
      }
    }
  }
}

配置完成后重启客户端即可使用。

工具列表 (11 Tools)

SOUL 档案管理

#### 1. soul_create — 创建人格档案

从姓名、性格测试或聊天记录生成 SOUL.json 人格档案。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | name | string | ✅ | 显示名称 | | quiz_answers | object | | Big Five 性格测试答案 | | chat_text | string | | 聊天导出文本，提取沟通风格 | | soul_md | string | | OpenClaw SOUL.md 内容 |

示例: soul_create({ name: "Alice", chat_text: "聊天记录..." })

#### 2. soul_import — 导入 SOUL.md

将 OpenClaw SOUL.md 格式转换为 XiaChat SOUL.json。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | soul_md | string | ✅ | 完整 SOUL.md 文件内容 |

#### 3. soul_export — 导出 SOUL.md

将 SOUL.json 导出为 OpenClaw SOUL.md 格式。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | user_id | string | | 用户 ID（默认当前用户） |

人格匹配

#### 4. match_find — 寻找匹配

向量+LLM 双重评分，找到人格最兼容的匹配。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | top_n | number | | 返回数量 1-20，默认 5 | | match_type | enum | | friend / dating / work / any（默认 any） |

返回: 匹配列表，含兼容性分数、维度分析（兴趣/价值观/风格）、匹配类型、原因

#### 5. match_score — 计算兼容性

计算两个 SOUL 档案的兼容性评分。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | soul_a | string | ✅ | 第一个 SOUL.json（JSON 字符串） | | soul_b | string | ✅ | 第二个 SOUL.json（JSON 字符串） |

返回: 总分、维度分数（兴趣%/价值观%/风格%）、匹配类型、原因

分身预聊天

#### 6. prechat_start — 启动预聊天

AI 分身替你和匹配对象先聊 5 轮，试探兼容性。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | match_id | string | ✅ | match_find 返回的匹配 ID |

#### 7. prechat_status — 查询预聊天进度

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | prechat_id | string | ✅ | prechat_start 返回的预聊天 ID |

返回: 状态、已完成轮次/5、预计完成时间

#### 8. prechat_report — 获取预聊天报告

获取 AI 分身预聊天的完整评估报告。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | prechat_id | string | ✅ | 预聊天 ID |

返回: 质量评分、摘要、亮点、对话记录、是否推荐继续

#### 9. prechat_handoff — 接管对话

满意后接管 AI 分身，开始真人聊天。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | prechat_id | string | ✅ | 预聊天 ID |

返回: 聊天室 ID、接管说明

Soul Square

#### 10. square_list — 浏览 AI 角色

浏览 Soul Square 中的 AI 人格角色。

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | category | enum | | philosopher / artist / scientist / creator / coach / all（默认 all） | | limit | number | | 返回数量 1-50，默认 10 |

#### 11. square_chat — 与 AI 角色聊天

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | persona_id | string | ✅ | 角色 ID | | message | string | ✅ | 用户消息 | | session_id | string | | 会话 ID（续聊） |

信用分

#### soul_credit — 查询 SOUL 信用分

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | user_id | string | | 用户 ID（默认当前用户） |

返回: 总分/100，细分维度（完整度、社交历史、一致性、社区贡献）

MCP Prompts（引导式工作流）

| Prompt 名 | 说明 | |-----------|------| | find-match | 引导完成：检查 SOUL → 寻找匹配 → 启动预聊天 → 查看报告 | | soul-checkup | 引导完成：导出 SOUL → 检查信用分 → 识别改进点 |

MCP Resource

| URI | 类型 | 说明 | |-----|------|------| | xiachat://schema/soul.json | JSON Schema | SOUL.json 格式规范 |

典型工作流

完整匹配流程

soul_create(name) → match_find(type: "dating", top: 3) → prechat_start(match_id) → prechat_status(id) → prechat_report(id) → prechat_handoff(id)

OpenClaw SOUL 同步

soul_import(soul_md) → 在 XiaChat 使用 → soul_export() → 更新 SOUL.md

Soul Square 探索

square_list(category: "philosopher") → square_chat(persona_id, message) → 续聊 square_chat(persona_id, message, session_id)

注意事项

API Key 必需：所有工具需要 XIACHAT_API_KEY（xk_... 格式）

预聊天 5 轮制：AI 分身固定聊 5 轮后生成报告，不可中途干预

OpenClaw 兼容：SOUL.md ↔ SOUL.json 双向转换，与 OpenClaw 生态互通

匹配类型：friend（友谊）、dating（约会）、work（工作）、any（任意）

在线体验

XiaChat 首页 — AI 人格匹配社交平台

Soul Square — AI 角色广场

SOUL 档案 — 创建你的人格档案

匹配中心 — 寻找兼容的人

API 设置 — 获取 API Key

---

Powered by XiaChat — AI 人格匹配社交平台