session-history-mcp by hir4ta - MCP Server

Session History MCP Server

Claude Codeでのセッション履歴を管理するMCPサーバーです。GPT-5を使って会話を自動要約し、検索可能な形式で保存します。

特徴

🤖 GPT-5による自動要約: 会話内容を構造化して要約
🔍 全文検索: 過去のセッションをキーワードで検索
🔗 関連セッション検出: AIが類似の作業セッションを自動リンク
💾 ローカルストレージ: SQLiteでデータを安全に保存
⚡ 高速検索: FTS5による全文検索インデックス

インストール

# リポジトリのクローン
git clone <repository-url>
cd session-history-mcp

# 依存関係のインストール
npm install

# ビルド
npm run build

設定

1. 環境変数の設定

OpenAI APIキーを環境変数に設定します：

export OPENAI_API_KEY="your-api-key-here"

2. Claude Codeでの設定

Claude Codeの設定ファイル（~/.config/claude-code/mcp.json）に以下を追加：

{
  "mcpServers": {
    "session-history": {
      "command": "node",
      "args": ["/path/to/session-history-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

または、npmでグローバルインストールした場合：

{
  "mcpServers": {
    "session-history": {
      "command": "session-history-mcp",
      "env": {
        "OPENAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

使い方

セッションの保存

// Claude Codeでの使用例
save_session({
  messages: [
    { role: "user", content: "Reactのパフォーマンスを改善したい" },
    { role: "assistant", content: "useMemoとuseCallbackを使いましょう..." }
  ],
  duration: "30min"
})

セッションの検索

// キーワードで検索
search_sessions({
  query: "React パフォーマンス",
  limit: 5
})

最近のセッション取得

list_recent_sessions({
  limit: 10
})

特定のセッション取得

get_session({
  session_id: "uuid-here"
})

ツール一覧

ツール名	説明
`save_session`	現在の会話を要約して保存
`search_sessions`	キーワードでセッションを検索
`get_session`	セッションIDで詳細を取得
`list_recent_sessions`	最近のセッション一覧を取得

データ構造

セッションは以下の情報を含みます：

{
  session_id: string;          // ユニークID
  timestamp: string;           // 作成日時
  duration?: string;           // 所要時間
  summary: string;             // 要約
  topics: string[];            // トピック
  files_modified: string[];    // 変更ファイル
  key_decisions: string[];     // 重要な決定事項
  related_sessions: string[];  // 関連セッション
}

開発

# 開発モードで起動
npm run dev

# ビルド
npm run build

# 本番起動
npm start

ストレージ

データは ~/.session-history-mcp/sessions.db に保存されます。

コスト

GPT-5を使用するため、APIコストが発生します：

入力: $1.25 / 1M tokens
出力: $10 / 1M tokens

平均的なセッション（10Kトークン入力、2Kトークン出力）で約$0.03です。

ライセンス

MIT

トラブルシューティング

OPENAI_API_KEYエラー

Error: OPENAI_API_KEY environment variable is required

→ 環境変数が正しく設定されているか確認してください。

データベースエラー

データベースファイルが破損した場合は、以下で削除して再起動：

rm ~/.session-history-mcp/sessions.db

hir4ta/session-history-mcp