ClaudeHistoryMCP

概述

ClaudeHistoryMCP 是一个专业的 MCP 服务器，用于索引 Claude Code 的对话历史，使其可搜索和可重用。它采用混合搜索方法，结合 BM25（关键词精度）和 TF-IDF（语义召回），并通过倒排排名融合（RRF）合并结果。该服务器会自动从对话中提取知识，包括决策、解决方案和错误修复模式，并在新会话开始时注入项目上下文。它支持过滤语法以进行精确搜索，并包含云同步功能以便知识共享。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• search_history

  Full-text search across all conversations with filter syntax

  试试:Have I dealt with this ECONNREFUSED error before?试试:Search for docker network errors in the last week
• find_solutions

  Find how you fixed errors/problems before

  试试:Find solutions for authentication issues试试:How did I fix CORS problems last month?
• get_session_summary

  Structured summary of any session

  试试:Summarize my last session试试:What happened in the Docker session yesterday?
• list_projects

  List all projects with session counts and dates

  试试:Show all my projects试试:List projects I've worked on in the last month
• find_patterns

  Discover recurring topics, workflows, and issues

  试试:What patterns emerge in my React development?试试:Find recurring deployment issues
• get_project_context

  Full project context (recent sessions, decisions, knowledge)

  试试:Get context for my current project试试:What decisions were made in the API project?
• cloud_sync_push

  Push knowledge and sessions to cloud server

  试试:Sync my history to cloud试试:Push latest session data
• cloud_sync_pull

  Pull knowledge and sessions from cloud server

  试试:Update my local history from cloud试试:Pull latest session data from server
• cloud_sync_status

  Check cloud sync configuration and connection

  试试:Check cloud sync status试试:Is my history syncing to cloud?

可对比工具

安装

git clone https://github.com/jhammant/ClaudeHistoryMCP.git
cd ClaudeHistoryMCP
npm install
npm run build

npm run build-index

claude mcp add claude-history -- node "/path/to/ClaudeHistoryMCP/dist/index.js"

npm run install-hook

## Claude History MCP

当 `claude-history` MCP 可用时，主动使用它：
- **会话开始**：使用 `get_project_context` 检查先前的决策、模式和最近的会话摘要
- **调试**：在从头开始之前，使用 `find_solutions` 搜索历史记录中的过去修复方案

FAQ

这与所有 Claude Code 对话兼容吗？

是的，它索引存储在 ~/.claude/projects/ 中的所有 JSONL 对话文件

历史数据库可以有多大？

测试显示约 170 个会话的索引构建时间约为 9 秒，搜索时间小于 200 毫秒

我可以跨设备同步知识吗？

是的，使用带有 ClaudeHistory Cloud 的可选云同步功能

ClaudeHistoryMCP 对比