项目简介
Agent Genesis是一个基于Model Context Protocol (MCP)构建的服务器应用,专门用于索引和搜索你在Claude Code和Claude Desktop中的对话历史。它通过语义理解技术让你能够按含义(而非关键词)查找过去的讨论、决策和解决方案。
主要功能
- 🔍 语义搜索 - 根据对话含义进行智能搜索
- 📚 双数据源支持 - 同时索引Claude Code(JSONL格式)和Claude Desktop(LevelDB格式)的对话
- ⚡ 快速索引 - 基于ChromaDB的向量搜索技术
- 📊 统计信息 - 查看已索引对话的数量和状态
- 🔄 自动索引 - 支持定时自动更新索引
- 🛠️ MCP集成 - 直接通过Claude Code的MCP协议使用
- 🐳 容器化部署 - 通过Docker Compose轻松设置
安装步骤
方法一:自动安装(推荐)
git clone https://github.com/Platano78/agent-genesis.git cd agent-genesis ./scripts/setup.sh
方法二:手动安装
- 克隆仓库并配置环境
git clone https://github.com/Platano78/agent-genesis.git cd agent-genesis cp .env.example .env cp docker-compose.template.yml docker-compose.yml
- 配置环境变量 编辑'.env'文件,设置Claude数据路径:
- 'CLAUDE_PROJECTS_PATH' - Claude Code项目路径(如'~/.claude/projects')
- 启动服务
docker-compose up -d
- 触发初始索引
curl -X POST http://localhost:8080/index/trigger
MCP服务器配置
在Claude Code配置文件中添加MCP服务器设置:
{ "mcpServers": { "agent-genesis": { "command": "agent-genesis-mcp", "args": [] } } }
使用方法
安装配置后,你可以在Claude Code中直接使用以下工具:
- 'search_conversations' - 语义搜索对话历史
- 'get_api_stats' - 获取索引统计信息
- 'check_api_health' - 检查API连通性
- 'manage_scheduler' - 管理自动索引计划
- 'index_conversations' - 手动触发对话索引
可用工具说明
- 搜索对话:输入查询语句,系统会返回语义上最相关的对话结果
- 健康检查:验证Agent Genesis API是否正常运行
信息
分类
开发者工具