dark-memory-mcp

╔════════════════════════════════════════════════════════════════════════════════════╗
║                                                                                    ║
║         ██████╗  ██████╗██████╗ ███╗   ███╗      ███╗   ███╗ ██████╗██████╗        ║
║        ██╔═══██╗██╔════╝██╔══██╗████╗ ████║      ████╗ ████║██╔════╝██╔══██╗       ║
║        ██║   ██║██║     ██║  ██║██╔████╔██║      ██╔████╔██║██║     ██████╔╝       ║
║        ██║   ██║██║     ██║  ██║██║╚██╔╝██║      ██║╚██╔╝██║██║     ██╔═══╝        ║
║        ▚██████╔╝╚██████╗██████╔╝██║ ╚═╝ ██║      ██║ ╚═╝ ██║╚██████╗██║            ║
║         ╚═════╝  ╚═════╝╚═════╝ ╚═╝     ╚═╝      ╚═╝     ╚═╝ ╚═════╝╚═╝            ║
║                                                                                    ║
║                     MEMORIA PERSISTENTE PARA AGENTES DE IA                         ║
║                                                                                    ║
╚════════════════════════════════════════════════════════════════════════════════════╝

解決する問題

Lunes:   "Vamos a refactorizar el módulo de autenticación."
         El agente trabaja. Tomas 5 decisiones de arquitectura.
         Cierras la sesión.

Martes:  "Continuemos con el refactor."
         El agente: "¿Qué refactor? ¿Qué módulo? ¿Quién eres?"
         Tienes que explicarle TODO otra vez. 20 minutos perdidos.

Dark Memory を使うと：

Lunes:   "Vamos a refactorizar el módulo de autenticación."
         El agente anota: proyecto, decisión #1, decisión #2...
         Todo queda en tu disco.

Martes:  Abres sesión. El agente recibe:
           - Proyecto: dark-memory-mcp
           - Decisiones del lunes: 5 (la #3: "RS256, no HS256")
           - Pendientes: 2
         "OK, ayer elegimos RS256, terminemos los tests."
         0 minutos de re-explicación.

あなたが Dark Memory と直接やり取りすることはありません。エージェント（Claude、opencode、Cursor）が、ノートを参照するように MCP 経由で使います。

Vibe-loop

依頼した内容と提出された内容の間をつなぎます。

Sin supervisión:
  Tú:    "Crea una API que devuelva productos filtrados por categoría."
  Agente: [200 líneas]
  Tú:    "También devuelve los borrados..."
  Agente: "Cierto." [150 líneas más]
  Tú:    "No tiene paginación."
  Agente: "..."  ← iteración sin fin

Con vibe-loop:
  1. CREAS LA PROMESA (spec)      → dark_memory_vibe_spec
  2. EL AGENTE TRABAJA
  3. ENTREGA EL ARTEFACTO         → dark_memory_vibe_publish
  4. EL JUEZ COMPARA entrega vs promesa:
        "aligned"        → cumple, adelante        ✅
        "drift_detected" → se desvió, reintenta    🔄
        "needs_human"    → no está seguro, te pregunta 🤔
  5. CIERRE — queda registrado qué pediste, qué entregaron, qué dijo el juez

あなたがすべての行を確認するのではありません。判定役が元の約束に照らして提出物を評価し、エージェントが自分で修正します。

クイックスタート

Node.js 18+（npm ラッパー）または Go 1.25+（ソースからのビルド）が必要です。

// Agrega esto a la config MCP de tu agente
{
  "mcpServers": {
    "dark-memory": {
      "command": "npx",
      "args": ["-y", "@opitacode/dark-memory-mcp"]
    }
  }
}

初回起動時に npx がシステム用のバイナリをダウンロードします。何もコンパイルする必要はありません。

動作確認

> "Llama a dark_memory_health_ping y dime qué responde."

{
  "server": { "version": "4.0.0-alpha.32", "name": "dark-memory-mcp" },
  "db": { "live": true, "schema_version": 32 },
  "registry": { "canonical_tools": 78 }
}

78 は、ライブ環境で測定された登録数です。server.version はビルドスタンプ（公開済みタグまたはローカルの疑似バージョン）です。重要なのは上記の形式、つまりライブ状態 + schema + 件数です。

server.version はビルドスタンプを反映します。-ldflags を指定せずにコンパイルした場合は、バージョンの代わりに dev と表示されます。これはエラーではありません。

はじめに

1. "Inicia sesión en dark-memory. Operador: [tu nombre]. Proyecto: mi-proyecto."
2. "Guarda: 'Estamos usando Postgres 16 con uuidv7 como PKs.'"
3. "¿Qué tenemos anotado sobre la base de datos?"
4. "Cierra la sesión."

ソースからビルドする場合：go build -o bin/dark-mem-mcp ./cmd/dark-mem-mcp ホストごとの詳細については、docs/npm-install.md をご覧ください。

レベルを選ぶ

レベル 1 — ノート。 エージェントがセッションをまたいで記憶します。初日におすすめです。 session_start、agent_memory_save、agent_memory_recall、session_close。

レベル 2 — Vibe-loop。 提出物が依頼内容を満たしているかを検証します。 約束するには vibe_spec、提出するには vibe_publish、判定結果には pipeline_status、受け入れるか拒否するかを決めるには resolve_drift を使います。

レベル 3 — 委任。 大規模な作業向けです。delegate_intent が直接実行するかサブエージェント間で実行するかを判断し、mindset_apply がプロンプトを組み立てます。

レベル 4 — 拡張。 ツールの追加、評価基準の調整、検索の改善を行います。 CONTRIBUTING.md → good first issues から始めましょう。

コード内で見かける用語

全カタログはこちら：docs/tools.md。

問題が起きた場合

正直に記載しています。売り込みだけの README では、判断の役に立ちません。

まだできないこと

判断の役に立たない README にはしたくないので、正直に記載します。

• プレリリースです。 レジストリで計測された正式なツールは 78 個です （環境変数で有効にする追加ツール 3 個を加えると 81 個）。対応範囲は リリースごとに拡大し、freeze test で確定します。これは alpha.31 からの差分で +5 です（vibe_compile + OAuth 名前空間の 4 個）。名前空間ごとの詳細は docs/v4-status.md §1 をご覧ください。
• Phase 21 は 9 個のプリミティブのうち 2 個までです。 vibe-loop エンジンは 検証済みのライブラリで、配線を開始した段階であり、完成した製品ではありません。残りの 7 個の プリミティブは挙動を変更するため、計測 → 測定 → 判断 → 切り替えが必要です。
• Postgres は実運用環境で未検証です。 58 個のメソッドが notImpl を返します（SQLite では 0 個）。 本番環境のパスは SQLite です。
• 外部ユーザーはまだいません。 作者が 2026-10-08 から毎日使用しています。

これらはすべて、日付と情報源を含めて docs/v4-status.md に記録されています。 internal/tools/v4_status_consistency_test.go は、そのドキュメントと実行中のコードに 矛盾があるとビルドを失敗させるため、内容がひそかに古くなることはありません。

内部の仕組み

Tu agente (Claude / opencode / Cursor)
    │  MCP (JSON-RPC sobre stdin/stdout)
    ▼
dark-mem-mcp.exe  ←── proceso local, 78+3 herramientas
    │  SQL
    ▼
SQLite (archivo .db en tu disco)   ←── o Postgres con DARK_DRIVER=postgres

• DB スキーマ： schema_migrations.version に記録された整数は 32 です。稼働中の インスタンスには、FTS5 のシャドウテーブルを含めて 66 個のテーブルがあります。
• 外部依存関係： 実行時の依存関係はありません。Go 標準ライブラリと組み込み SQLite を使用します。
• テスト： 正式な数値は CI のものであり、この README の数値ではありません。README に数値をコピーすることは、このプロジェクトがやめたことそのものです。

コントリビューション

MIT ライセンスです。あらゆるレベルのコントリビューションを歓迎します。

1. CONTRIBUTING.md — プロジェクトのルール
2. §10 公開情報の正確性を保つ — このプロジェクトが痛い経験から学んだルール
3. すべてのコントリビューションは vibe-loop を経由します：spec → artifact → drift_judge → マージ

設計原則：

• 追記のみ： マイグレーションは編集せず、追加のみ行います
• 正規の順序： ツールには固定の順序があり、番号を振り直しません
• ベストエフォート： VLP、スイーパー、テレメトリーが主要な処理をブロックすることはありません
• ハードコーディングなし： 数値、名前、バージョンごとに唯一の信頼できる情報源を設けます