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 許可證。