使用说明
Claude会话搜索MCP服务器
用于搜索和浏览Claude Code会话历史的MCP服务器。
特性
一级工具
- 搜索_提示 -在所有用户提示中进行模糊搜索
- list_sessions -使用过滤器和排序浏览会话
- get_session -检索完整的会话记录(JSON或Markdown)
- get_session_summary -获取会话摘要和元数据
安装
cd ~/angel-studios/.claude/mcp-servers/claude-session-search
yarn install
yarn build
发展
yarn dev
配置
集 CLAUDE_HOME 用于覆盖默认值的环境变量 ~/.claude 位置。
会话历史架构
Claude Code将会话历史存储在两层中:
全球提示指数
- 位置:
~/.claude/history.jsonl - 格式:每行一个JSON对象,带有提示、时间戳和项目
完整会议记录
- 位置:
~/.claude/projects/{encoded-path}/{session-uuid}.jsonl - 格式:每行一个JSON对象,包含消息、摘要和元数据
工具使用示例
搜索提示
mcp__claude-session-search__search_prompts({
query: "GraphQL",
project: "angel-studios",
limit: 10
})
列出会话
mcp__claude-session-search__list_sessions({
project: "angel-studios",
sortBy: "date",
sortOrder: "desc",
limit: 20
})
获取会话
mcp__claude-session-search__get_session({
sessionId: "01d8a33b-7ac1-48bb-83cc-56ec4a9167b1",
format: "markdown"
})
获取会话摘要
mcp__claude-session-search__get_session_summary({
sessionId: "01d8a33b-7ac1-48bb-83cc-56ec4a9167b1"
})
