Ai Sessions MCP

🚀 AI Sessions MCP Server

AI Sessions MCP Server 是一个 MCP 服务器，它能让 Claude Code、OpenAI Codex、Gemini CLI 和 opencode 等工具的会话可供任何与 MCP 兼容的客户端使用。

本项目大部分代码由 Claude Code 编写。

🚀 快速开始

AI Sessions MCP Server 允许 AI 代理从多个 CLI 编码工具中搜索、列出和读取你之前的本地编码会话。这在以下场景中非常有用：

• 查找过去类似问题的解决方案。
• 回顾最近的工作内容。
• 从之前的对话中学习。
• 恢复中断的工作。

演示

在 Codex CLI 中恢复 Claude Code 会话。

✨ 主要特性

• 支持从多个 CLI 编码工具（Claude Code、OpenAI Codex、Gemini CLI 和 opencode）读取本地编码会话。
• 提供 CLI 工具用于上传 Claude Code 会话记录到 aisessions.dev 进行分享。
• 支持多种搜索和筛选会话的方式，方便用户快速找到所需会话。

📦 安装指南

快速安装

macOS、Linux 和 Windows（Git Bash/WSL）：

curl -fsSL https://aisessions.dev/install.sh | bash

此命令会将二进制文件安装到 ~/.aisessions/bin。请按照提示将其添加到系统的 PATH 中。

自定义安装目录：

INSTALL_DIR=/custom/path curl -fsSL https://aisessions.dev/install.sh | bash

手动下载

你可以从 GitHub Releases 下载预构建的二进制文件。

从源代码构建

前提条件：需要安装 Go 1.25 或更高版本。

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

配置

安装完成后，需要配置你的 MCP 客户端以使用该二进制文件：

Claude Code

claude mcp add ai-sessions ~/.aisessions/bin/aisessions

如果你使用的是自定义安装路径，则使用以下命令：

claude mcp add ai-sessions /path/to/aisessions

Codex CLI

编辑 ~/.codex/config.toml 文件：

[mcp_servers.ai_sessions]
command = "~/.aisessions/bin/aisessions"

Claude Desktop

在配置文件中添加以下内容（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "ai-sessions": {
      "command": "/Users/YOUR_USERNAME/.aisessions/bin/aisessions"
    }
  }
}

请将 YOUR_USERNAME 替换为你实际的用户名，或者使用你的自定义安装路径。

重启 Claude Desktop 以使配置生效。

💻 使用示例

CLI 上传

ai-sessions 二进制文件包含一个 CLI 工具，用于将 Claude Code 会话记录上传到 aisessions.dev 进行分享。

认证

aisessions login

此命令会打开你的浏览器以生成 CLI 令牌。令牌会被保存到本地的 ~/.aisessions/config.json 文件中。

上传会话

交互式模式（不提供文件参数）：

aisessions upload

此命令会显示一个可搜索的列表，其中包含你最近的 Claude Code 会话。你可以使用箭头键导航并选择要上传的会话。

直接模式（提供文件路径）：

aisessions upload /path/to/session.jsonl
aisessions upload /path/to/session.jsonl --title "自定义标题"

选项

• --title <标题> - 为上传的会话记录设置自定义标题。

MCP 使用

一旦将其配置为 MCP 服务器，你可以提出以下问题：

• "让我们继续我最近的 Claude Code 会话"
• "显示我最近的 Codex 会话"
• "在我的会话中搜索认证错误"
• "Claude 昨天告诉我 绝对正确 多少次？"

🔧 技术细节

工作原理

服务器会读取各个 CLI 编码工具本地存储的会话文件：

• Claude Code：~/.claude/projects/[项目目录]/*.jsonl
• Gemini CLI：~/.gemini/tmp/[项目哈希]/chats/session-*.json
• OpenAI Codex：~/.codex/sessions/ 和 ~/.codex/archived_sessions/
• opencode：~/.local/share/opencode/storage/ 当你要求 AI 代理列出或搜索会话时，它会自动使用这些工具来访问你的会话历史记录。

可用工具

list_available_sources

显示系统中哪些 AI CLI 编码工具存在会话。

list_sessions

列出所有项目的最近会话（最新的在前）。 参数：

• source（可选）：按 claude、gemini、codex 或 opencode 进行过滤。
• project_path（可选）：按特定项目目录进行过滤。
• limit（可选）：最大结果数（默认：10）。 示例：{"source": "claude", "limit": 20}

search_sessions

使用 BM25 排名算法搜索会话内容。返回按相关性得分排序的结果，并包含上下文片段。 参数：

• query（必需）：搜索词（支持多个关键词）。
• source（可选）：按来源进行过滤。
• project_path（可选）：按项目进行过滤。
• limit（可选）：最大结果数（默认：10）。 示例：{"query": "认证错误"} 返回结果：每个匹配项包含：
• session：会话元数据（ID、来源、项目、时间戳）。
• score：相关性得分（得分越高，相关性越强）。
• snippet：上下文摘录（约 300 个字符），显示匹配发生的位置。

get_session

分页检索完整的会话内容。 参数：

• session_id（必需）：会话 ID（从列表结果中获取）。
• source（必需）：创建该会话的编码工具。
• page（可选）：页码（默认：0）。
• page_size（可选）：每页的消息数（默认：20）。

📚 详细文档

开发

为了保持代码格式一致并尽早发现回归问题，请遵循以下步骤：

• 安装 pre-commit 并运行 pre-commit install 以启用钩子（gofmt、go vet、go test）。
• 所有推送和拉取请求都会触发 GitHub Actions 工作流（.github/workflows/build.yml），该工作流会检查代码格式、运行 go vet、构建二进制文件并执行 go test -cover ./...。

📄 许可证

本项目采用 MIT 许可证。