memory-bridge-mcp 1.2.0__tar.gz

memory_bridge_mcp-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LE-VAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

memory_bridge_mcp-1.2.0/NOTICE.md

@@ -0,0 +1,29 @@
+# Notices
+
+Memory Bridge is distributed as source code under the MIT License.
+
+This repository does not bundle Honcho, Ollama, or any external services.
+
+## Third-party components
+
+### Mind concept graph
+
+The vendored `mind/` module is a local concept-graph memory system.
+
+- Source: ATLAS project
+- License: MIT
+
+### Honcho
+
+Honcho is used as a semantic vector memory store.
+
+- Project: https://github.com/aphoh/honcho
+- License: MIT
+- Distribution note: this repository does not bundle Honcho. Users install and run Honcho separately.
+
+### Ollama
+
+Ollama is used optionally for LLM-powered memory synthesis.
+
+- Project: https://ollama.ai
+- Distribution note: this repository does not bundle Ollama. Users install and run Ollama separately.

memory_bridge_mcp-1.2.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.2
+Name: memory-bridge-mcp
+Version: 1.2.0
+Summary: Unified MCP memory server bridging Mind (concept graph) and Honcho (semantic vector) memory with episodic timeline and LLM synthesis
+Author: LE-VAI
+License: MIT License
+Project-URL: Homepage, https://github.com/LE-VAI/memory-bridge
+Project-URL: Repository, https://github.com/LE-VAI/memory-bridge
+Project-URL: Documentation, https://github.com/LE-VAI/memory-bridge#readme
+Keywords: mcp,memory,mind,honcho,llm,synthesis,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE.md
+
+# Memory Bridge MCP
+
+**Unified MCP memory server** — bridges Mind (concept graph) and Honcho (semantic vector) memory with episodic timeline and LLM synthesis into a single MCP query surface.
+
+```
+pip install memory-bridge-mcp
+```
+
+## What it does
+
+Memory Bridge exposes 8 MCP tools that let any MCP-compatible agent (Claude Code, Codex, etc.) store and recall memories across three memory systems:
+
+| Tool | Purpose |
+|---|---|
+| `bridge_remember` | Store a memory — auto-routes short facts to Mind, long content to Honcho |
+| `bridge_recall` | Unified recall across both systems with Reciprocal Rank Fusion |
+| `bridge_status` | Combined health report for all memory systems |
+| `bridge_episode_record` | Record a structured session episode |
+| `bridge_episode_recall` | Search episodic timeline by text, time, and tags |
+| `bridge_timeline` | Chronological view of all session episodes |
+| `bridge_synthesize` | Cortex Accelerator — synthesize knowledge across all memory |
+| `bridge_contradictions` | Detect contradictory memories |
+
+## Quick start
+
+```bash
+# Install
+pip install memory-bridge-mcp
+
+# Run as MCP server (stdio)
+memory-bridge
+```
+
+The server speaks the [MCP protocol](https://modelcontextprotocol.io) over stdio. Configure it as an MCP server in your agent's config:
+
+```json
+{
+  "mcpServers": {
+    "memory-bridge": {
+      "command": "memory-bridge"
+    }
+  }
+}
+```
+
+## Memory systems
+
+### Mind (concept graph)
+A local, zero-dependency concept graph with spreading-activation recall, Ebbinghaus forgetting, and dream consolidation. Stored in `.mind/graph.json` in the working directory. The vendored `mind.py` module handles all graph operations.
+
+### Honcho (semantic vector)
+An optional semantic vector store running on `http://127.0.0.1:8000`. Provides embedding-based similarity search. If Honcho is unavailable, the bridge falls back to Mind only.
+
+### Episodic (session timeline)
+A JSONL-based append-only log of structured session episodes. Stored in `.memory-bridge/episodes.jsonl`. Supports text search, time-range filtering, tag filtering, and session filtering.
+
+### Synthesis (Cortex Accelerator)
+Optionally uses a local Ollama instance (`http://127.0.0.1:11434`) to synthesize related memories into concise summaries. Falls back to extractive key-sentence selection when LLM is unavailable.
+
+## Configuration
+
+The server reads these environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `HONCHO_BASE_URL` | `http://127.0.0.1:8000/v3` | Honcho API endpoint |
+| `OLLAMA_BASE_URL` | `http://127.0.0.1:11434` | Ollama API endpoint |
+| `OLLAMA_SYNTHESIS_MODEL` | `qwen3:8b` | Model for LLM synthesis |
+
+## Architecture
+
+```
+┌──────────────┐     ┌──────────────┐     ┌──────────────┐
+│   Agent      │     │   Agent      │     │   Agent      │
+│ (Claude,     │     │ (Codex,      │     │ (any MCP)    │
+│  Codex, ...) │     │  ...)        │     │              │
+└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
+       │                    │                    │
+       └────────────────────┼────────────────────┘
+                            │ MCP stdio
+                    ┌───────▼────────┐
+                    │  Memory Bridge  │
+                    │  MCP Server     │
+                    └───┬────┬────┬──┘
+                        │    │    │
+              ┌─────────┘    │    └──────────┐
+              ▼              ▼                ▼
+       ┌──────────┐  ┌──────────┐  ┌──────────────┐
+       │   Mind   │  │  Honcho  │  │  Episodic     │
+       │  Graph   │  │  Vector  │  │  Timeline     │
+       │ (local)  │  │ (HTTP)   │  │  (JSONL)      │
+       └──────────┘  └──────────┘  └──────────────┘
+```
+
+## Zero dependencies
+
+The core server uses only the Python standard library. No pip dependencies required. The vendored `mind.py` module is also zero-dependency.
+
+## License
+
+MIT

memory_bridge_mcp-1.2.0/README.md

@@ -0,0 +1,101 @@
+# Memory Bridge MCP
+
+**Unified MCP memory server** — bridges Mind (concept graph) and Honcho (semantic vector) memory with episodic timeline and LLM synthesis into a single MCP query surface.
+
+```
+pip install memory-bridge-mcp
+```
+
+## What it does
+
+Memory Bridge exposes 8 MCP tools that let any MCP-compatible agent (Claude Code, Codex, etc.) store and recall memories across three memory systems:
+
+| Tool | Purpose |
+|---|---|
+| `bridge_remember` | Store a memory — auto-routes short facts to Mind, long content to Honcho |
+| `bridge_recall` | Unified recall across both systems with Reciprocal Rank Fusion |
+| `bridge_status` | Combined health report for all memory systems |
+| `bridge_episode_record` | Record a structured session episode |
+| `bridge_episode_recall` | Search episodic timeline by text, time, and tags |
+| `bridge_timeline` | Chronological view of all session episodes |
+| `bridge_synthesize` | Cortex Accelerator — synthesize knowledge across all memory |
+| `bridge_contradictions` | Detect contradictory memories |
+
+## Quick start
+
+```bash
+# Install
+pip install memory-bridge-mcp
+
+# Run as MCP server (stdio)
+memory-bridge
+```
+
+The server speaks the [MCP protocol](https://modelcontextprotocol.io) over stdio. Configure it as an MCP server in your agent's config:
+
+```json
+{
+  "mcpServers": {
+    "memory-bridge": {
+      "command": "memory-bridge"
+    }
+  }
+}
+```
+
+## Memory systems
+
+### Mind (concept graph)
+A local, zero-dependency concept graph with spreading-activation recall, Ebbinghaus forgetting, and dream consolidation. Stored in `.mind/graph.json` in the working directory. The vendored `mind.py` module handles all graph operations.
+
+### Honcho (semantic vector)
+An optional semantic vector store running on `http://127.0.0.1:8000`. Provides embedding-based similarity search. If Honcho is unavailable, the bridge falls back to Mind only.
+
+### Episodic (session timeline)
+A JSONL-based append-only log of structured session episodes. Stored in `.memory-bridge/episodes.jsonl`. Supports text search, time-range filtering, tag filtering, and session filtering.
+
+### Synthesis (Cortex Accelerator)
+Optionally uses a local Ollama instance (`http://127.0.0.1:11434`) to synthesize related memories into concise summaries. Falls back to extractive key-sentence selection when LLM is unavailable.
+
+## Configuration
+
+The server reads these environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `HONCHO_BASE_URL` | `http://127.0.0.1:8000/v3` | Honcho API endpoint |
+| `OLLAMA_BASE_URL` | `http://127.0.0.1:11434` | Ollama API endpoint |
+| `OLLAMA_SYNTHESIS_MODEL` | `qwen3:8b` | Model for LLM synthesis |
+
+## Architecture
+
+```
+┌──────────────┐     ┌──────────────┐     ┌──────────────┐
+│   Agent      │     │   Agent      │     │   Agent      │
+│ (Claude,     │     │ (Codex,      │     │ (any MCP)    │
+│  Codex, ...) │     │  ...)        │     │              │
+└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
+       │                    │                    │
+       └────────────────────┼────────────────────┘
+                            │ MCP stdio
+                    ┌───────▼────────┐
+                    │  Memory Bridge  │
+                    │  MCP Server     │
+                    └───┬────┬────┬──┘
+                        │    │    │
+              ┌─────────┘    │    └──────────┐
+              ▼              ▼                ▼
+       ┌──────────┐  ┌──────────┐  ┌──────────────┐
+       │   Mind   │  │  Honcho  │  │  Episodic     │
+       │  Graph   │  │  Vector  │  │  Timeline     │
+       │ (local)  │  │ (HTTP)   │  │  (JSONL)      │
+       └──────────┘  └──────────┘  └──────────────┘
+```
+
+## Zero dependencies
+
+The core server uses only the Python standard library. No pip dependencies required. The vendored `mind.py` module is also zero-dependency.
+
+## License
+
+MIT

memory_bridge_mcp-1.2.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68,<77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "memory-bridge-mcp"
+version = "1.2.0"
+description = "Unified MCP memory server bridging Mind (concept graph) and Honcho (semantic vector) memory with episodic timeline and LLM synthesis"
+readme = "README.md"
+license = {text = "MIT License"}
+authors = [
+    {name = "LE-VAI"},
+]
+keywords = ["mcp", "memory", "mind", "honcho", "llm", "synthesis", "agent"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.10"
+
+[project.urls]
+Homepage = "https://github.com/LE-VAI/memory-bridge"
+Repository = "https://github.com/LE-VAI/memory-bridge"
+Documentation = "https://github.com/LE-VAI/memory-bridge#readme"
+
+[project.scripts]
+memory-bridge = "memory_bridge.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

memory_bridge_mcp-1.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

memory_bridge_mcp-1.2.0/src/memory_bridge/__init__.py

@@ -0,0 +1,7 @@
+"""memory-bridge-mcp — unified MCP memory server.
+
+Bridges Mind (concept graph) and Honcho (semantic vector) memory
+with episodic timeline and LLM synthesis into a single MCP query surface.
+"""
+
+__version__ = "1.2.0"

memory_bridge_mcp-1.2.0/src/memory_bridge/__main__.py

@@ -0,0 +1,6 @@
+"""memory-bridge-mcp — entry point for `memory-bridge` CLI command."""
+
+from memory_bridge.server import main
+
+if __name__ == "__main__":
+    main()

memory_bridge_mcp-1.2.0/src/memory_bridge/mind/__init__.py

@@ -0,0 +1 @@
+"""Vendored mind concept-graph memory module."""