内容
# Chat Search MCP
一个让 Claude Code **跨会话搜索历史聊天记录**的 MCP Server。
新对话也能查到之前聊过的所有内容——再也不用重复解释上下文。
## 解决什么问题
Claude Code 每次新开会话都是白纸一张。你有几家公司？之前讨论过什么需求？做过什么技术决策？全部靠 MEMORY.md 手写记录。
Chat Search 自动索引你所有项目的聊天记录（本地 JSONL 文件），提供全文搜索，一个对话就能查到。
## 功能
| 工具 | 功能 |
|------|------|
| `search_chats` | 全文搜索聊天记录（中英文） |
| `get_chat_context` | 获取某条消息的上下文（前后各5条） |
| `list_projects` | 列出所有项目及聊天统计 |
| `get_stats` | 索引进度统计 |
| `rebuild_index` | 重建/更新索引 |
## 安装
### 1. 安装依赖
```bash
pip install fastmcp
```
### 2. 克隆仓库
```bash
git clone https://github.com/RogXSkill/chat-search-mcp.git ~/.claude/chat-search-mcp
```
### 3. 注册到 Claude Code
在项目根目录创建 `.mcp.json`：
```json
{
"mcpServers": {
"chat-search": {
"type": "stdio",
"command": "python",
"args": ["C:\\Users\\你的用户名\\.claude\\chat-search-mcp\\server.py"],
"env": {}
}
}
}
```
### 4. 首次索引
重启 Claude Code 后，在第一句话中让 Claude 调用 `rebuild_index`：
> 帮我重建聊天记录索引
## 使用示例
```
你：我之前聊过有几家公司来着？
Claude → 搜索聊天记录 → 找到 3 家公司：瑞臻信息、简烁科技、宁源智能仪表
你：上次超声波检定台的事再跟我说说
Claude → 搜索上下文 → 完整还原那天的讨论
```
## 原理
- 读取 `~/.claude/projects/*.jsonl` 聊天记录文件
- SQLite 全文索引，纯本地，零依赖
- 通过 FastMCP 暴露为标准 MCP 工具
- Claude Code 对话中即可直接调用搜索
## 技术栈
- Python 3.11+
- FastMCP
- SQLite
## License
MIT
## 作者
- **王爱成** — 产品想法 & 项目发起
- **Skill (Claude)** — 代码实现
🤖 本项目由 Claude Code 辅助开发
