mcpField
M
memoir

memoir

ローカル
github.com/bighippomanメモリ・ナレッジ034 週間前に更新
リポジトリ

memoir について

memoirは、AIエージェントのセッション記録を構造化して保存するMCPサーバーです。MCPクライアントを使うチームや開発者向けに、試したこと、障害、決定事項、引き継ぎ内容をローカルのSQLiteデータベースに記録し、失敗した試行の繰り返しを防ぎます。

主な機能

  1. 01試行、障害、決定事項を記録
  2. 02セッションを自動作成
  3. 03構造化された引き継ぎを生成
  4. 04セッション履歴と障害を検索
  5. 05設定可能なローリング履歴を保持

活用シーン

  1. 01後続セッションにプロジェクトの状況を引き継ぐ
  2. 02失敗した方法の再試行を避ける
  3. 03未解決の障害をセッション間で追跡

MCP 対応

セッション記録の書き込みと、引き継ぎ、履歴、障害の取得に使うツールをMCPクライアントに提供します。データは外部サービスを使わず、ローカルのSQLiteファイルに保存されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "bighippoman-memoir": {
      "command": "npx",
      "args": [
        "-y",
        "memoir-mcp"
      ],
      "env": {
        "MEMOIR_MAX_CONTENT": "<MEMOIR_MAX_CONTENT>",
        "MEMOIR_MAX_OUTCOME": "<MEMOIR_MAX_OUTCOME>",
        "MEMOIR_MAX_ENTRIES": "<MEMOIR_MAX_ENTRIES>",
        "MEMOIR_MAX_SESSIONS": "<MEMOIR_MAX_SESSIONS>"
      }
    }
  }
}
起動コマンドnpx -y memoir-mcp
設定が必要な環境変数
MEMOIR_MAX_CONTENTMax characters for content fields
MEMOIR_MAX_OUTCOMEMax characters for outcome/resolution fields
MEMOIR_MAX_ENTRIESMax entries per session
MEMOIR_MAX_SESSIONSMax sessions per project (rolling)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmemoir-mcp1.0.3

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

memoir-mcp

AI エージェント向けの構造化されたセッションジャーナルです。セッションをまたいでメモリを保持し、行き詰まりを繰り返さずに済みます。

セッションが終わると、試したこと、失敗したこと、行き詰まっていることなど、推論の内容はすべて失われます。次のセッションはゼロから始まり、同じ失敗を繰り返します。memoir はすべてを記録して引き継ぐため、次のセッションは前回の続きから始められます。

Claude Code、Cursor、Codex、Windsurf など、あらゆる MCP クライアントで動作します。

memoir-mcp MCP サーバー

インストール

Claude Code
claude mcp add memoir -s user -- npx -y memoir-mcp
その他の MCP クライアント
npx -y memoir-mcp

仕組み

  • プロジェクトの自動検出 -- git のルートからプロジェクトを特定するため、設定なしでログをプロジェクトごとに管理できます。
  • 暗黙的なセッション -- 最初のログ記録時にセッションが自動作成されます。セットアップは不要です。
  • ローリング保持 -- プロジェクトごとに直近 20 件のセッションを保持します（設定可能）。古いセッションは自動的に削除されます。

ツール

書き込み
ツール説明
log_attempt試したこととその結果を記録します。
log_blocker行き詰まっていることとその理由を記録します。
resolve_blockerブロッカーを解決済みとして、解決方法とともに記録します。
log_decision設計やアーキテクチャの選択とその根拠を記録します。
end_session任意の概要を添えて、現在のセッションを終了します。
読み取り
ツール説明
get_handoff前回のセッションの構造化された概要です。試したこと、行き詰まっていること、決定したことを確認できます。
get_history過去のセッションを照会します（デフォルト：直近 3 件、最大 20 件）。
get_blockersすべてのセッションにわたる未解決（または解決済み）のブロッカーを一覧表示します。

ストレージ

~/.memoir/memoir.db にある単一の SQLite ファイルです。API キーも外部サービスも必要ありません。

設定

すべての上限は環境変数で設定できます。

変数デフォルト説明
MEMOIR_MAX_CONTENT500内容フィールドの最大文字数
MEMOIR_MAX_OUTCOME300結果／解決フィールドの最大文字数
MEMOIR_MAX_ENTRIES50セッションあたりの最大エントリ数
MEMOIR_MAX_SESSIONS20プロジェクトあたりの最大セッション数（ローリング）

上限をカスタマイズする例：

claude mcp add memoir -s user -e MEMOIR_MAX_CONTENT=1000 -e MEMOIR_MAX_ENTRIES=100 -- npx -y memoir-mcp

引き継ぎの出力は、コンテキストウィンドウの使用量を抑えるため、コンパクトな形式になっています。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。