cc-channel-mem(ClaudeCode チャネルメモ)

Tool

概要

cc-channel-mem は、Discord と Telegram のサーバーチャネルで発生する会話をローカルに永続化し、Claude Code(ClaudeCode)セッションと独立にメモリを保持・提供するための MCP(Memory Control Plane)サーバとバックグラウンドデーモンのセットです。特徴は「受信即保存」「無損失保存」「Bot B 専用(保存のみ、応答は行わない)」の3原則で、チャネルメッセージを原文のまま保存しておき、次回の Claude Code セッション開始時に関連する会話履歴を自動で注入することで、セッション間のコンテキスト継続性を実現します。npm 経由でグローバルインストールでき、CLI によるセットアップ機能も備えます。

GitHub

リポジトリの統計情報

  • スター数: 6
  • フォーク数: 0
  • ウォッチャー数: 6
  • コミット数: 5
  • ファイル数: 11
  • メインの言語: JavaScript

主な特徴

  • 受信即保存:メッセージ受信直後に永続化。セッション終了イベントに依存しない。
  • 無損失保存:AI判定やフィルタで削ることなく、メッセージを原文のまま保存。
  • MCP サーバ連携:保存したメモリを Claude Code セッション開始時に自動注入。
  • Bot B 専用動作:保存のみ行い、チャネルで応答しない設計で監視用途に最適。

技術的なポイント

cc-channel-mem は Node.js(JavaScript)で実装された軽量なデーモン+MCP サーバの組み合わせです。デーモン側は Discord/Telegram のボット API を用いてサーバーチャネルのメッセージを購読し、受信イベントをトリガーに直ちにローカル永続化処理を行います。設計上の重要な判断は「受信即保存」と「無損失保存」で、これはネットワーク切断やセッション切れによるメモリロスを防ぎ、後段の LLM(ClaudeCode)側で必要に応じてフィルタリング・要約させる前提です。

保存層はリポジトリの構成から軽量でローカル志向(フラットファイルや組み込みDBを想定)になっており、シンプルなデプロイで動かせる点が利点です。MCP サーバは保存された会話データに対して検索や関連度計算を行い、Claude Code セッション開始時に「関連するメモリ」を選んで注入する役割を担います。セキュリティ面ではボットトークンや API キーは設定ディレクトリで管理する設計が想定され、プライバシー要件が高い環境では暗号化や外部ストレージへの移行が検討されるべきです。

運用面の注意点としては、無損失保存ポリシーのため保存容量が増大しやすいこと、ローカル保存は単一ノード構成で可用性に制約があること、また ClaudeCode へ注入する際に適切なフィルタ(時間窓、ユーザー、キーワード、要約)を設けないとセッションに過剰な文脈が流れ込む可能性がある点が挙げられます。リポジトリには CLI(cc-channel-mem setup)とベンチマークスクリプトが含まれ、ローカルでの試験的導入や性能測定がしやすく設計されています。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • README.md: file
  • benchmark.js: file
  • bin: dir
  • config: dir

…他 6 ファイル

(備考)README やロゴ(logo.png)を含み、npm グローバルインストールで提供される CLI 実行ファイルが含まれている構成です。

まとめ

ローカル永続化と Claude Code 連携に特化した軽量なメモリ保存ソリューション。簡単導入でセッション継続性を強化可能。

リポジトリ情報:

READMEの抜粋:

cc-channel-mem

CC ChannelMem Logo

Discord/Telegram 서버 채널의 대화를 Claude Code 세션과 독립적으로 로컬에 영구 저장하고, 다음 Claude Code 세션 시작 시 관련 메모리를 자동 주입하는 MCP 서버 + 백그라운드 데몬.

핵심 원칙

  • 수신 즉시 저장 — 세션 종료 이벤트에 의존하지 않음. 데몬이 살아있으면 무조건 저장.
  • 무손실 저장 — AI 판단 없이 모든 메시지를 원본 그대로 저장.
  • 봇 B 전용 — 서버 채널 메시지 저장만. 응답 없음.

설치

npm install -g cc-channel-mem
# 또는 로컬 경로로 직접 사용

빠른 시작

1. 봇 설정

cc-channel-mem setup

Dis…