项目简介

AI会话MCP服务器是一个应用后端，它通过Model Context Protocol (MCP) 标准，将您本地各种AI编码助手（如Claude Code、Gemini CLI、OpenAI Codex和opencode）的历史编码会话整合起来。这意味着您可以使用任何兼容MCP的LLM客户端（如Claude Desktop、Codex CLI），以标准化的方式搜索、列出并读取您过去的编程会话，极大地方便了会话回顾、问题查找和中断工作的恢复。

主要功能点

统一会话管理: 自动发现并聚合来自Claude Code、Gemini CLI、OpenAI Codex和opencode等多个AI编码助手的本地历史会话。
会话列表与筛选: 允许您根据会话来源（如“claude”、“gemini”）或特定项目路径，列出最近的会话记录。
高级会话搜索: 利用BM25排名算法，对所有会话内容进行高效的全文搜索，帮助您快速找到解决类似问题或包含特定关键词的过去会话，并提供匹配上下文片段。
完整会话内容获取: 支持分页功能，您可以按需获取任何历史会话的完整聊天消息内容。
CLI 上传工具: 额外提供了一个命令行工具，方便您将本地Claude Code会话转录文件上传到 'aisessions.dev' 平台进行分享。

安装步骤

您可以选择下载预构建的二进制文件或从源代码构建：

1. 下载预构建二进制文件

访问项目的 GitHub Releases 页面，下载与您的操作系统相对应的最新版本。
解压下载的文件。
将解压后的 'ai-sessions' 可执行文件移动到您系统PATH环境变量中的某个位置（例如 '/usr/local/bin' 或 'C:\Windows'），或者您选择的任何目录。在配置MCP客户端时，您将需要此文件的完整路径。

2. 从源代码构建

前提条件: 确保您已安装 Go 1.25 或更高版本。
打开终端或命令行界面，导航到您克隆的 'ai-sessions-mcp' 仓库目录。

运行以下命令进行编译：

go build -o bin/ai-sessions ./cmd/ai-sessions

编译完成后，您会在 'bin/' 目录下找到 'ai-sessions' 可执行文件。将其移动到您希望的任何位置，并在MCP客户端配置中使用其路径。

服务器配置（MCP客户端使用）

MCP服务器本身无需额外配置即可运行，但您的MCP客户端需要知道如何启动它。以下是几种常见MCP客户端的配置示例。您需要将 '/path/to/ai-sessions' 替换为您实际的 'ai-sessions' 可执行文件路径。

Claude Code (CLI): 在终端中运行以下命令：
```
claude mcp add ai-sessions /path/to/ai-sessions
```
这条命令会告诉Claude Code CLI，有一个名为 'ai-sessions' 的MCP服务器，其启动命令是指定路径下的可执行文件。
Codex CLI: 编辑您的Codex配置文件 ('~/.codex/config.toml')，在 '[mcp_servers]' 部分添加如下内容：
```
[mcp_servers.ai_session]
command = "/path/to/ai-sessions"
```
这会将 'ai_session' 注册为一个MCP服务器，并指定其启动命令。

Claude Desktop: 打开Claude Desktop的配置文件（通常通过 'Settings' -> 'Developer' -> 'Edit Config'），在 'mcpServers' 对象中添加以下JSON片段：

{
  "mcpServers": {
    "ai-sessions": {
      "command": "/path/to/ai-sessions"
    }
  }
}

保存文件后，重启Claude Desktop 以激活新的MCP服务器配置。

基本使用方法

一旦AI会话MCP服务器在您的MCP客户端中配置并运行，您就可以通过自然语言向AI助手提出请求，调用其提供的工具功能：

查询最新会话:
- “继续我最新的Claude Code会话。”
- “显示我最近的Codex会话。”
- “列出过去一周内所有Gemini CLI的会话。”
搜索历史会话:
- “搜索我的会话，看看有没有关于身份验证bug的解决方案。”
- “Claude昨天告诉我‘绝对正确’的次数是多少？”
- “在我的opencode会话中查找关于Kubernetes部署的问题。”
获取会话详情:
- 在列出或搜索会话后，AI助手通常会提供会话ID，您可以进一步询问详情，例如：“获取会话ID为 'sess-12345' 的完整内容。”

这些请求会被MCP客户端转换成对AI会话MCP服务器的工具调用，服务器将执行相应的会话查找、读取或搜索操作，并将结果返回给AI助手。

关键词