- 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 人格匹配社交平台