git clone https://github.com/sjcxxx-afk/personal-memory.git
cd personal-memory

# 安装核心依赖（不包含ChromaDB）
pip install mcp pydantic

# 或者安装完整依赖（包含ChromaDB，需要更多时间）
pip install -r requirements.txt

# 直接运行
python run_server.py

# 或者使用模块方式运行
python -m src.server

{
  "mcpServers": {
    "personal-memory": {
      "command": "python",
      "args": ["run_server.py"],
      "env": {
        "PYTHONPATH": "D:\\个人项目\\个人知识库\\personal-memory"
      }
    }
  }
}

# 构建并启动服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

{
  "mcpServers": {
    "personal-memory": {
      "command": "docker",
      "args": ["exec", "-i", "personal-memory-service", "python", "-m", "src.server"],
      "env": {}
    }
  }
}

{
  "content": "用户对花生过敏",
  "scene": "health",
  "source": "chat_2026-09-07",
  "importance": "high"
}

{
  "query": "过敏信息",
  "scene_filter": "health",
  "limit": 5
}

{
  "scene_filter": "work",
  "limit": 10
}

{
  "fact_id": "fact-uuid-here"
}

{}

personal-memory/
├── src/                    # 源代码
│   ├── server.py          # MCP服务器主入口
│   ├── models.py          # 数据模型定义
│   ├── storage/           # 存储层
│   │   ├── fact_store.py  # SQLite存储
│   │   └── vector_store.py # ChromaDB向量存储
│   ├── tools/             # MCP工具实现
│   │   ├── store_tool.py  # 存储工具
│   │   └── search_tool.py # 搜索工具
│   └── utils/             # 工具函数
├── data/                  # 数据目录
│   ├── facts/            # 冷存储
│   └── chroma/           # ChromaDB数据
├── config/               # 配置文件
├── Dockerfile            # Docker配置
├── docker-compose.yml    # Docker Compose配置
└── requirements.txt      # Python依赖

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt

# 运行服务器
python -m src.server

# 运行测试
pytest tests/

# 测试MCP工具
python -c "
import asyncio
from src.tools.store_tool import StoreTool
from src.tools.search_tool import SearchTool

async def test():
    store = StoreTool()
    search = SearchTool()
    
    # 测试存储
    result = await store.store_fact('测试事实', 'test', 'test', 'medium')
    print('存储结果:', result)
    
    # 测试搜索
    result = await search.search_facts('测试', limit=3)
    print('搜索结果:', result)

asyncio.run(test())
"

错误: Error initializing ChromaDB
解决: 检查data/chroma目录权限，确保可写

错误: MCP server connection failed
解决: 检查Docker容器是否运行，端口是否正确

错误: pip install failed
解决: 使用国内镜像源
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple