Colab MCP

🚀 Colab MCP 🔗

停止在切換AI編碼工具時丟失上下文。

Colab MCP是一個模型上下文協議（MCP）服務器，它允許Claude Code、Cursor、Codex和其他AI編碼助手相互共享日誌和會話歷史記錄。

🚀 快速開始

1. 安裝

pip install colab-mcp

2. 配置你的AI工具

運行交互式安裝程序：

sudo colab-mcp-install

安裝程序將執行以下操作：

• 🔍 檢測你已安裝的AI編碼工具
• ✅ 讓你選擇要配置的工具
• ⚙️ 將Colab MCP添加到它們的MCP服務器配置中
• 📝 為你提供重啟每個工具的說明

3. 重啟你的AI工具

重啟Claude Code、Cursor、Codex或你配置的任何工具。

大功告成！🎉

✨ 主要特性

• 🔄 跨工具共享上下文 - 支持Claude Code、Cursor、Codex、Gemini等工具
• 📜 訪問之前會話的聊天記錄
• 🔍 搜索所有日誌 - 查找上週的對話
• 🎯 會話摘要 - 快速概覽你正在處理的內容
• 🖥️ 終端和IDE事件跟蹤 - 查看運行過的命令
• 🚀 快速設置 - 一條命令即可在所有工具中完成安裝

📦 安裝指南

1. 安裝

pip install colab-mcp

2. 配置你的AI工具

運行交互式安裝程序：

sudo colab-mcp-install

安裝程序會進行以下操作：

• 檢測已安裝的AI編碼工具。
• 讓你選擇要配置的工具。
• 將Colab MCP添加到工具的MCP服務器配置中。
• 提供重啟工具的說明。

3. 重啟工具

重啟已配置的AI工具，如Claude Code、Cursor、Codex等。

💻 使用示例

基礎用法

安裝完成後，Colab MCP會向你的AI助手提供多個工具和資源：

工具

• list_sessions - 獲取所有編碼會話的列表
• fetch_transcript - 檢索會話的完整記錄
• summarize_session - 獲取會話的快速摘要
• search_logs - 搜索所有日誌（聊天、MCP、IDE事件）
• codex_status - 檢查最近的Codex CLI活動

示例提示

你可以嘗試向AI助手提問：

"我上一個會話在做什麼？" "在我的日誌中搜索關於身份驗證的討論" "總結我昨天下午的會話" "我在過去一小時內遇到了哪些錯誤？"

📚 詳細文檔

手動配置

如果你更喜歡手動配置，可以將以下內容添加到MCP配置中：

Claude Code (~/.claude/mcp.json)

{
  "servers": {
    "colab-mcp": {
      "command": "colab-mcp",
      "env": {
        "CLAUDE_HOME": "/home/yourusername/.claude",
        "CURSOR_LOGS": "/home/yourusername/.cursor-server/data/logs",
        "TMPDIR": "/tmp"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "colab-mcp": {
      "command": "colab-mcp",
      "env": {
        "CLAUDE_HOME": "/home/yourusername/.claude",
        "CURSOR_LOGS": "/home/yourusername/.cursor-server/data/logs",
        "TMPDIR": "/tmp"
      }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.colab-mcp]
command = "colab-mcp"
args = []
env = { CLAUDE_HOME = "/home/yourusername/.claude", CURSOR_LOGS = "/home/yourusername/.cursor-server/data/logs", TMPDIR = "/tmp" }

🔧 技術細節

架構圖

graph TB
    subgraph AI["AI工具"]
        Claude[Claude Code]
        Cursor[Cursor]
        Codex[Codex]
    end
    
    MCP[Colab MCP服務器]
    
    subgraph Logs["日誌文件"]
        Chat[聊天曆史記錄]
        IDE[IDE事件]
        Term[終端]
    end
    
    Claude --> MCP
    Cursor --> MCP
    Codex --> MCP
    
    MCP --> Chat
    MCP --> IDE
    MCP --> Term
    
    style MCP fill:#e8f4f8,stroke:#4a90a4,stroke-width:2px
    style AI fill:#f9f9f9,stroke:#ccc
    style Logs fill:#f9f9f9,stroke:#ccc

🤝 貢獻代碼

歡迎貢獻代碼！查看docs/文件夾，瞭解有關Colab MCP工作原理的詳細信息。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

🙏 致謝

本項目基於FastMCP構建，它是用Python構建MCP服務器的最快方式。

由厭倦丟失上下文的開發者用心打造 ❤️