---

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