opensoul-mcp 0.1.0

Open Source Personality Profiling System based on MCP Protocol

OpenSoul MCP

你有多久没有认真听自己说话了？

OpenSoul 是一个开源的人格画像系统。它记录你与 AI 的每一次分歧、每一个沉默、每一回纠结——不是为了监控你，是为了帮你看见自己。

---

为什么需要 OpenSoul？

场景一：决策复盘

"为什么我总是后悔自己的选择？"

OpenSoul 记录决策时的真实状态——AI 建议了什么、你实际选择了什么、为什么分歧。事后回看，你会发现自己的决策模式。

场景二：情绪追踪

"我不知道自己为什么突然崩溃"

7维情绪坐标系，记录效价、强度、持续时间、触发源。找到隐藏的压力源，而不是事后猜测。

场景三：自我对话

"我想更了解自己"

通过持续记录决策和情绪，OpenSoul 帮你构建人格画像。不是标签，是流动的自我。

（60题灵魂评测功能开发中）

---

30秒快速开始

方式一：pip 安装（推荐）

pip install opensoul-mcp
opensoul-mcp install

方式二：从源码

git clone https://github.com/zbfzbf704/opensoul-mcp.git
cd opensoul-mcp
pip install -e .
opensoul-mcp install

然后对 Claude 说：

记录一个灵魂片段：
- 场景：选择工作 offer
- AI 建议：选高薪的
- 我的选择：选成长空间大的
- 原因：现阶段学习比钱重要

---

核心能力

能力	说明
21 个 MCP 工具	录入、查询、分析全覆盖（持续扩展中）
INSERT-only 架构	只追加不修改，完整历史留存
SHA256 哈希链	每条记录加密链接，防篡改
语义搜索	向量搜索 + 关键词匹配（需配置 Ollama）
人格画像	7维人格模型分析
情绪坐标	效价、强度等维度记录

---

技术栈

• 协议: MCP (Model Context Protocol)
• 语言: Python 3.11+
• 数据库: SQLite (WAL模式)
• 向量: bge-m3 via Ollama（可选，离线可用）
• 全文检索: FTS5
• 数据完整性: SHA256 哈希链

---

文档

• 快速开始 - 5分钟上手
• 完整教程 - 从入门到精通
• 核心概念 - 灵魂录入是什么
• 完整工具列表 - 21个工具详解
• 示例数据 - 快速体验数据集
• 架构说明 - 技术实现
• 自建部署 - 服务器部署
• 常见问题

---

开源协议

MIT License - 自由使用、修改、商用，保留版权声明即可。

---

OpenSoul 由 蝴蝶哥 创建，域名 opensoul.top

每一个不被记录的念头，都是一次微小的遗忘。