Colab MCP

🚀 Colab MCP 🔗

AIコーディングツールを切り替える際にコンテキストを失うことを防ぎます。

Claude Code、Cursor、CodexなどのAIコーディングアシスタント間でログとセッション履歴を共有できるModel Context Protocol (MCP)サーバーです。

🚀 クイックスタート

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つのコマンドでインストール

📚 ドキュメント

💻 使用例

基本的な使用法

インストール後、Colab MCPはいくつかのツールとリソースをAIアシスタントに公開します。

ツール

• list_sessions - すべてのコーディングセッションのリストを取得
• fetch_transcript - セッションの完全なトランスクリプトを取得
• summarize_session - 作業内容の概要を取得
• search_logs - すべてのログ（チャット、MCP、IDEイベント）を検索
• codex_status - 最近のCodex CLIのアクティビティを確認

プロンプトの例

AIアシスタントに以下のような質問を試してみてください。

"前回のセッションで何を作業していたか教えて" "認証に関する議論をログから検索して" "昨日の午後のセッションを要約して" "過去1時間で遭遇したエラーを教えて"

🛠️ 手動設定

手動で設定する場合は、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 Tools"]
        Claude[Claude Code]
        Cursor[Cursor]
        Codex[Codex]
    end
    
    MCP[Colab MCP Server]
    
    subgraph Logs["Log Files"]
        Chat[Chat History]
        IDE[IDE Events]
        Term[Terminal]
    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

🤝 コントリビューション

コントリビューションは大歓迎です！ Colab MCPの仕組みについて詳しい情報はdocs/フォルダを確認してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

🙏 謝辞

FastMCPを使用して構築されています。PythonでMCPサーバーを構築する最速の方法です。

コンテキストを失うのに疲れた開発者たちによって❤️ で作られました