内容
# 本地克劳德聊天记录服务器
一款用于搜索您**本地**克劳德对话记录的MCP服务器 — 克劳德将对话记录存储为本地文件。
| 来源 | 位置 | 描述 |
|--------|----------|------------|
| `代码` | `~/.claude/projects/**/*.jsonl` | 克劳德代码CLI/桌面会话 |
| `协作` | `~/Library/Application Support/Claude/local-agent-mode-sessions` (macOS) | 克劳德协作（本地代理模式）会话 |
所有操作都在本地通过stdio运行 — 它只读取已经存在于磁盘上的文件，任何数据都不会上传到其他地方。
方便用于回答以下问题：
- *"今天/这周我都在做什么？"*
- *"我在哪次会话中设置了ADX代理？"*
- *"我最近一次修改了排行榜缓存代码是什么时候？"*
> **范围 — 仅限本地。** 此工具搜索克劳德写入磁盘的记录（克劳德代码和克劳德协作）。您的常规 **claude.ai / 克劳德桌面聊天记录存储在Anthropic的云端，而非本地** ，因此此工具无法读取这些记录，它们也被故意排除在此范围之外。
## 使用方法
### 克劳德代码插件（推荐）
此仓库是一个克劳德代码插件和其自己的市场。您可以通过以下方式安装：
```bash
# 从GitHub
claude plugin marketplace add daniellmorris/local-claude-chat-history-mcp
claude plugin install local-claude-chat-history@local-claude-chat-history
# 或从本地克隆
claude plugin marketplace add /path/to/local-claude-chat-history-mcp
claude plugin install local-claude-chat-history@local-claude-chat-history
```
或在克劳德代码中交互式安装： `/plugin marketplace add …` 然后 `/plugin install local-claude-chat-history`。
该插件运行捆绑的服务器 `dist/server.mjs` — 在安装它的机器上无需 `npm install`。
在不安装的情况下快速测试：
```bash
claude --plugin-dir /path/to/local-claude-chat-history-mcp
```
### 克劳德代码（纯MCP服务器）
```bash
claude mcp add claude-history -- npx -y github:daniellmorris/local-claude-chat-history-mcp
```
### 克劳德桌面 / 其他MCP客户端
```json
{
"mcpServers": {
"claude-history": {
"command": "npx",
"args": ["-y", "github:daniellmorris/local-claude-chat-history-mcp"]
}
}
}
```
## 工具
### `搜索历史记录`
跨两个来源进行全文搜索，最新的会话优先。
| 参数 | 默认值 | 描述 |
|-------|---------|-------------|
| `查询` | — | 不区分大小写的子字符串（或使用 `regex: true` 的正则表达式） |
| `来源` | `所有` | `所有` \| `代码` \| `协作` |
| `项目` | — | 项目路径或会话标题的子字符串筛选 |
| `角色` | `任意` | `用户` \| `助手` |
| `之后` / `之前` | — | ISO日期边界（例如 `2026-07-09`） |
| `限制` / `每会话最大` | 20 / 3 | 结果限制 |
返回带有 `会话ID` 的匹配片段。
### `列出会话`
浏览最近的会话（ID、标题、项目、时间戳），使用相同的 `来源`/`项目` 筛选。非常适合“今天我做了什么”。
### `获取会话`
通过 `会话ID` 读取完整的对话，按 `偏移量`/`限制` 分页，每个消息截断为 `最大字符数`。
## 配置
所有配置项均为可选，通过环境变量配置：
| 变量 | 目的 |
|----------|---------|
| `CLAUDE_CODE_HISTORY_DIR` | 覆盖 `~/.claude/projects` |
| `CLAUDE_COWORK_SESSIONS_DIR` | 覆盖协作会话目录 |
## 开发
```bash
npm install
npx @modelcontextprotocol/inspector node index.js
```
该插件附带一个无依赖的捆绑包 `dist/server.mjs`（已提交到仓库）。更改 `index.js` 或 `lib/` 后，请重建：
```bash
npm run build
```
## 许可证
MIT
