Ai Sessions MCP

🚀 AI Sessions MCP Server

AI Sessions MCP Serverは、Claude Code、OpenAI Codex、Gemini CLI、opencodeなどの複数のCLIコーディングエージェントからのコーディングセッションを、任意のMCP互換クライアントで利用可能にするMCPサーバーです。これにより、過去のコーディングセッションを検索、一覧表示、読み取ることができ、類似の問題の過去の解決策を見つけたり、最近の作業を振り返ったりするのに役立ちます。

このプロジェクトの大部分はClaude Codeを使用して作成されています。

🚀 クイックスタート

AI Sessions MCP Serverは、複数のCLIコーディングエージェントで作成されたコーディングセッションを管理するためのサーバーです。以下の手順に従って、サーバーをインストールして使用を開始しましょう。

✨ 主な機能

• 複数のCLIコーディングエージェント（Claude Code、OpenAI Codex、Gemini CLI、opencode）からのコーディングセッションを管理できます。
• 過去のコーディングセッションを検索、一覧表示、読み取ることができます。
• 中断した作業を再開することができます。
• コーディングセッションを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

設定ファイル（Settings → Developer → Edit Config）に以下を追加します。

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

YOUR_USERNAMEを実際のユーザー名に置き換えるか、カスタムインストールパスを使用してください。

Claude Desktopを再起動して設定を有効にします。

💻 使用例

基本的な使用法

CLIアップロード

ai-sessionsバイナリには、Claude Codeのトランスクリプトをaisessions.devにアップロードして共有するためのCLIツールが含まれています。

認証

aisessions login

このコマンドを実行すると、ブラウザが開き、CLIトークンが生成されます。トークンは~/.aisessions/config.jsonにローカルに保存されます。

セッションのアップロード

インタラクティブモード（ファイル引数なし）:

aisessions upload

最近のClaude Codeセッションの検索可能なリストが表示されます。矢印キーを使用して移動し、アップロードするセッションを選択します。

直接モード（ファイルパス付き）:

aisessions upload /path/to/session.jsonl
aisessions upload /path/to/session.jsonl --title "Custom Title"

オプション

• --title <title> - アップロードするトランスクリプトにカスタムタイトルを設定します。

MCPの使用

MCPサーバーとして構成した後、以下のような質問をすることができます。

• "Let's continue my latest sesion from Claude Code"
• "Show me my recent Codex sessions"
• "Search my sessions for authentication bugs"
• "How many times did Claude tell me I was absolutely right yesterday?"

高度な使用法

サーバーは、さまざまなCLIコーディングエージェントがローカルに保存したセッションファイルを読み取ります。

• Claude Code: ~/.claude/projects/[PROJECT_DIR]/*.jsonl
• Gemini CLI: ~/.gemini/tmp/[PROJECT_HASH]/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": "authentication bug"}

返り値: 各マッチには以下が含まれます。

• 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ライセンスの下で公開されています。