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 — 獲取預聊天報告

小蔥技能站7w4.net每天更新，海量AI技能等你發現。

獲取 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（引導式工作流）

MCP Resource

典型工作流

完整匹配流程

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

這個 Skill 質量中上，功能比較齊全，文件清晰易讀，工具設計合理。主要優點是工具數量充足、說明詳細、工作流完整；不足之處是全英文文件對國內使用者不太友好，且缺少使用示例，新手可能較難快速上手。總體而言是一款功能完善的工具型 Skill，但使用者體驗還有最佳化空間。