Claude Codeにセッションを跨いだ長期記憶を持たせるため、SQLiteとローカル埋め込みモデルを活用したハイブリッド検索対応MCPサーバー「engram」の開発手法を解説。
詳細内容
Claude Codeの課題である「セッションごとの文脈リセット」を解決するため、長期記憶を管理するMCPサーバー「engram」を構築した技術解説記事。主な技術スタックとして、SQLite、sqlite-vec、日本語特化モデルのRuri v3-310mを採用し、外部API不要のフルローカル環境を実現。検索エンジンにはFTS5によるトリグラム全文検索とベクトル検索をRRFで統合するハイブリッド方式を導入し、時間減衰や重複排除のロジックも実装されている。また、Pythonの重量級ライブラリ読み込みによるMCP起動タイムアウト問題の回避策として、遅延インポートと`__future__.annotations`を用いた実装の工夫が共有されており、実用的なAI開発環境の構築に役立つ内容となっている。