项目简介

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

方法二:手动安装

  1. 克隆仓库并配置环境
git clone https://github.com/Platano78/agent-genesis.git
cd agent-genesis
cp .env.example .env
cp docker-compose.template.yml docker-compose.yml
  1. 配置环境变量 编辑'.env'文件,设置Claude数据路径:
  • 'CLAUDE_PROJECTS_PATH' - Claude Code项目路径(如'~/.claude/projects')
  1. 启动服务
docker-compose up -d
  1. 触发初始索引
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是否正常运行

信息

分类

开发者工具