会话历史MCP服务器
本地MCP服务器，使用关键字和语义搜索对Claude Code对话历史进行索引和搜索。
特性
- 关键词搜索 -使用SQLite FTS5进行快速全文搜索
- 语义搜索 -使用本地嵌入查找概念上相似的对话
- 会话列表 -浏览最近的会话及其摘要
- 上下文检索 -从过去的对话中获取完整的上下文
- 完全私人 -所有数据都保持本地，没有外部API调用
安装
先决条件
- Python 3.10+
- Claude 代码命令行界面
快速安装
# Clone the repo
git clone https://github.com/SDillon001/conversation-history-mcp.git
cd conversation-history-mcp
# Install dependencies
pip install -r requirements.txt
# Create symlink to Claude's MCP directory
mkdir -p ~/.claude/mcp-servers
ln -s "$(pwd)" ~/.claude/mcp-servers/conversation-history
# Add to Claude Code settings
# See Configuration section below配置
添加到您的 ~/.claude.json 在...之下 mcpServers 按键：
{
"mcpServers": {
"conversation-history": {
"type": "stdio",
"command": "python3",
"args": ["server.py"],
"cwd": "/path/to/conversation-history-mcp"
}
}
}替换 /path/to/conversation-history-mcp 安装的实际路径。
用法
配置后，以下工具在任何Claude Code会话中都可用：
搜索会话
在所有对话历史中搜索关键字。
"Search for conversations about authentication"
→ Claude calls search_sessions(query="authentication")搜索_语义
语义搜索，查找概念上相似的对话。
"Find conversations similar to database optimization"
→ Claude calls search_semantic(query="database optimization")list_sessions
列出最近的会议及其摘要。
"What did I work on last week?"
→ Claude calls list_sessions(days=7)get_session
从特定会话中获取完整上下文。
"Show me the full conversation from session abc123"
→ Claude calls get_session(session_id="abc123")rebuild_index
强制重建搜索索引（通常不需要）。
"Rebuild the conversation index"
→ Claude calls rebuild_index()运作原理
- 索引 -启动时，服务器扫描
~/.claude/projects/用于JSONL会话文件 - FTS5 -邮件在SQLite中通过全文搜索进行索引
- 嵌入 -使用
sentence-transformers/all-MiniLM-L6-v2（在本地运行） - 增量 -只有新会话在首次运行后才会被索引
数据存储
~/.claude/mcp-servers/conversation-history/
└── data/
├── index.db # SQLite with FTS5 (keyword search)
└── chroma/ # ChromaDB (semantic search embeddings)您的对话历史记录将保留在 ~/.claude/projects/ -此服务器仅创建搜索索引。
隐私
- 没有外部API调用 -本地生成的嵌入
- 没有数据离开您的机器 -一切都在里面
~/.claude/ - 只读访问 -服务器只读取会话文件，从不修改它们
发展
# Run server directly for testing
python server.py
# Run tests
pytest tests/许可证
麻省理工学院