memoryintelligence-mcp 0.2.13__tar.gz → 0.2.14__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of memoryintelligence-mcp might be problematic. Click here for more details.

Files changed (24) hide show
  1. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/CHANGELOG.md +80 -2
  2. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/PKG-INFO +17 -3
  3. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/README.md +14 -0
  4. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/pyproject.toml +4 -3
  5. memoryintelligence_mcp-0.2.14/src/mi_mcp/__init__.py +32 -0
  6. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/__main__.py +6 -1
  7. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/cli.py +3 -1
  8. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/server.py +21 -2
  9. memoryintelligence_mcp-0.2.13/src/mi_mcp/__init__.py +0 -3
  10. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/.gitignore +0 -0
  11. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/CONTRIBUTING.md +0 -0
  12. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/LICENSE +0 -0
  13. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/client.py +0 -0
  14. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/config.py +0 -0
  15. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/embedder.py +0 -0
  16. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/indexer.py +0 -0
  17. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/keys.py +0 -0
  18. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/local_index.py +0 -0
  19. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/localreads.py +0 -0
  20. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/paths.py +0 -0
  21. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/recall_guard.py +0 -0
  22. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/scrub.py +0 -0
  23. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/umo_format.py +0 -0
  24. {memoryintelligence_mcp-0.2.13 → memoryintelligence_mcp-0.2.14}/src/mi_mcp/vault.py +0 -0
@@ -3,7 +3,72 @@
3
3
  All notable changes to `memoryintelligence-mcp` are documented here.
4
4
  The format follows [Keep a Changelog](https://keepachangelog.com/); this project uses [Semantic Versioning](https://semver.org/).
5
5
 
6
- ## [0.2.13] — 2026-08-12
6
+ ## [0.2.14] — 2026-10-19 — FINAL RELEASE
7
+
8
+ ### Deprecated — this package is retired; 0.2.14 is its last release (#2186)
9
+
10
+ `[KASEY-STATED 2026-09-18, release decided 2026-10-19]` `mi-local` — this package — is
11
+ retired. It keeps working exactly as it does today, but it receives no further updates,
12
+ fixes, or tools. Nothing is removed in this release; the deprecation is a **signal**, not a
13
+ cut.
14
+
15
+ **What replaces it**
16
+
17
+ - **On your computer:** the MemoryIntelligence desktop app's built-in MCP server
18
+ (*Connect Claude* inside the app). It sees everything you connect to MI — including
19
+ sources this package never could, such as Drive imports — and it enforces the
20
+ per-category disclosure you choose there. This package's redaction is pattern-matched
21
+ PII; the desktop's is the choice you actually made.
22
+ - **On the web and phone:** the claude.ai **MemoryIntelligence** connector (the remote
23
+ MCP served by the API).
24
+
25
+ **What you will see**
26
+
27
+ Every start of the server, and every `mi-mcp setup` / `mi-mcp doctor`, prints one line to
28
+ **stderr** (never stdout — stdout is the MCP transport):
29
+
30
+ ```
31
+ [mi-mcp] DEPRECATED: mi-mcp (mi-local) is DEPRECATED and 0.2.14 is its final release. It keeps working, but receives no further updates. Use the MemoryIntelligence desktop app's built-in MCP (Connect Claude) on your computer, or the claude.ai MemoryIntelligence connector on the web and phone. Details: https://github.com/somewhere11/MemoryIntelligence/issues/2186
32
+ ```
33
+
34
+ In a host that shows MCP logs (Claude Desktop's MCP log, Claude Code's `--mcp-debug`) that
35
+ line appears on each connection. The PyPI listing carries `Development Status :: 7 -
36
+ Inactive` and the same sentence in its summary; `server.json` says the same to the MCP
37
+ registry.
38
+
39
+ **Why a final release at all, rather than silence:** the package already on PyPI (0.2.13)
40
+ would otherwise keep being installed from docs and search results with no signal that it
41
+ is going away — the exact "nobody who has it configured ever sees the notice" failure
42
+ #2186 names. The two changes below had also landed on `main` under 0.2.14 without
43
+ shipping, which is the version-drift mode #2186 exists to end; this release closes it.
44
+
45
+ ### Added — `mi_ask` reports whether your memory can answer at all (#1117)
46
+
47
+ `mi_ask` results now carry `answerable` (boolean) at the envelope level, with
48
+ `top_similarity` beside it when the API provides one. Every hit already carried a
49
+ `score`, but on the cross-encoder scale most read `0.0`, so a junk row and a good row
50
+ looked identical to a reading model. `answerable` is the one field that separates them.
51
+ It is **advisory**: the rows are still returned and may be cited; this says what MI thinks,
52
+ it does not withhold.
53
+
54
+ ### Added — memories carry their stored title (#2258)
55
+
56
+ `mi_ask` and `mi_list` results include `title` on a memory and `memory_title` on a claim
57
+ (the title of the memory it was cut from), when the API has one. The API now stores one
58
+ title per memory (migration 079) instead of each surface inventing a label.
59
+
60
+ ### Not changed — large captures can still time out on the client (#1669)
61
+
62
+ The 30-second read timeout on `mi_capture` is unchanged. `[MEASURED 2026-08-17]` the
63
+ captures that failed took 1m45s–2m50s server-side, so no reasonable timeout bump makes them
64
+ reliable; the real fix is an idempotency key and a non-blocking capture, which belongs in
65
+ the surfaces that replace this one, not in a final release. After a `ReadTimeout`, do not
66
+ retry — call `mi_list` and check whether the capture landed.
67
+
68
+ ## [0.2.13] — 2026-08-13
69
+
70
+ > Ships **both** its own fix and 0.2.12's — see the note under [0.2.12].
71
+
7
72
 
8
73
  ### Fixed — `setup` could not be re-run without re-entering your API key (#1351)
9
74
 
@@ -21,7 +86,20 @@ Desktop / Code / Cursor and never touches your key — `doctor` recommended it i
21
86
  places, but the failure is precisely for the user who does not run `doctor` first. The
22
87
  `--help` epilog now says which of the two you need.
23
88
 
24
- ## [0.2.12] — 2026-08-12
89
+ ## [0.2.12] — 2026-08-12 — NEVER PUBLISHED
90
+
91
+ > ⚠️ **There is no 0.2.12 on PyPI.** The index goes 0.2.11 → 0.2.13.
92
+ >
93
+ > This number was minted on the branch for #1253, and #1351's branch independently
94
+ > minted the same one. The `MCP version + release-drift guard` is there to stop two
95
+ > different bodies of code shipping under one released version (#1135, the two-0.2.2s
96
+ > incident), so the second branch moved to 0.2.13 rather than reusing it.
97
+ >
98
+ > **The fix described below did ship — in 0.2.13**, together with #1351's. This
99
+ > section is kept rather than merged upward so the version history stays continuous
100
+ > for anyone reading top to bottom, and so `#1253 → 0.2.12` in the commit trail
101
+ > resolves to something.
102
+
25
103
 
26
104
  ### Fixed — local recency was corpus-relative, so importing one old memory reordered every result (#1253)
27
105
 
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: memoryintelligence-mcp
3
- Version: 0.2.13
4
- Summary: MCP server for MemoryIntelligence — give Claude a memory you own, set up in one command
3
+ Version: 0.2.14
4
+ Summary: DEPRECATED — final release (0.2.14). Use the MemoryIntelligence desktop app's MCP or the claude.ai connector. MCP server for MemoryIntelligence.
5
5
  Project-URL: Homepage, https://memoryintelligence.io
6
6
  Project-URL: Repository, https://github.com/somewhere11/memoryintelligence-mcp
7
7
  Project-URL: Issues, https://github.com/somewhere11/memoryintelligence-mcp/issues
@@ -11,7 +11,7 @@ Author-email: Somewhere <connect@somewheremedia.com>
11
11
  License-Expression: Apache-2.0
12
12
  License-File: LICENSE
13
13
  Keywords: ai,claude,llm,mcp,memory,memory-intelligence,model-context-protocol
14
- Classifier: Development Status :: 4 - Beta
14
+ Classifier: Development Status :: 7 - Inactive
15
15
  Classifier: Intended Audience :: Developers
16
16
  Classifier: Programming Language :: Python :: 3
17
17
  Classifier: Programming Language :: Python :: 3.10
@@ -39,6 +39,20 @@ Description-Content-Type: text/markdown
39
39
 
40
40
  # MemoryIntelligence MCP Server
41
41
 
42
+ > ## ⚠️ DEPRECATED — 0.2.14 is the final release
43
+ >
44
+ > This package (`mi-local`) is retired. It keeps working but receives no further
45
+ > updates, fixes, or new tools. Replace it with:
46
+ >
47
+ > - **On your computer:** the MemoryIntelligence desktop app's built-in MCP
48
+ > (*Connect Claude* inside the app). It sees everything you connect to MI and
49
+ > enforces the per-category disclosure you choose there, which this package
50
+ > never could.
51
+ > - **On the web and phone:** the claude.ai **MemoryIntelligence** connector.
52
+ >
53
+ > Every start of `mi-mcp`, `mi-mcp setup` and `mi-mcp doctor` prints this notice
54
+ > to stderr. Decision and rationale: [MemoryIntelligence#2186](https://github.com/somewhere11/MemoryIntelligence/issues/2186).
55
+
42
56
  [![PyPI](https://img.shields.io/pypi/v/memoryintelligence-mcp.svg)](https://pypi.org/project/memoryintelligence-mcp/)
43
57
  [![Python](https://img.shields.io/pypi/pyversions/memoryintelligence-mcp.svg)](https://pypi.org/project/memoryintelligence-mcp/)
44
58
  [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
@@ -1,5 +1,19 @@
1
1
  # MemoryIntelligence MCP Server
2
2
 
3
+ > ## ⚠️ DEPRECATED — 0.2.14 is the final release
4
+ >
5
+ > This package (`mi-local`) is retired. It keeps working but receives no further
6
+ > updates, fixes, or new tools. Replace it with:
7
+ >
8
+ > - **On your computer:** the MemoryIntelligence desktop app's built-in MCP
9
+ > (*Connect Claude* inside the app). It sees everything you connect to MI and
10
+ > enforces the per-category disclosure you choose there, which this package
11
+ > never could.
12
+ > - **On the web and phone:** the claude.ai **MemoryIntelligence** connector.
13
+ >
14
+ > Every start of `mi-mcp`, `mi-mcp setup` and `mi-mcp doctor` prints this notice
15
+ > to stderr. Decision and rationale: [MemoryIntelligence#2186](https://github.com/somewhere11/MemoryIntelligence/issues/2186).
16
+
3
17
  [![PyPI](https://img.shields.io/pypi/v/memoryintelligence-mcp.svg)](https://pypi.org/project/memoryintelligence-mcp/)
4
18
  [![Python](https://img.shields.io/pypi/pyversions/memoryintelligence-mcp.svg)](https://pypi.org/project/memoryintelligence-mcp/)
5
19
  [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
@@ -4,15 +4,16 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "memoryintelligence-mcp"
7
- version = "0.2.13"
8
- description = "MCP server for MemoryIntelligence — give Claude a memory you own, set up in one command"
7
+ version = "0.2.14"
8
+ description = "DEPRECATED — final release (0.2.14). Use the MemoryIntelligence desktop app's MCP or the claude.ai connector. MCP server for MemoryIntelligence."
9
9
  readme = "README.md"
10
10
  license = "Apache-2.0"
11
11
  requires-python = ">=3.10"
12
12
  authors = [{ name = "Somewhere", email = "connect@somewheremedia.com" }]
13
13
  keywords = ["mcp", "model-context-protocol", "memory-intelligence", "claude", "llm", "memory", "ai"]
14
14
  classifiers = [
15
- "Development Status :: 4 - Beta",
15
+ # 7 - Inactive: 0.2.14 is the final release (#2186). PyPI shows this status.
16
+ "Development Status :: 7 - Inactive",
16
17
  "Intended Audience :: Developers",
17
18
  "Programming Language :: Python :: 3",
18
19
  "Programming Language :: Python :: 3.10",
@@ -0,0 +1,32 @@
1
+ """MI MCP Server — MemoryIntelligence tools for Claude.
2
+
3
+ DEPRECATED — 0.2.14 is the FINAL release of this package (`mi-local`).
4
+ See :data:`DEPRECATION_NOTICE` and somewhere11/MemoryIntelligence#2186.
5
+ """
6
+
7
+ import sys
8
+
9
+ __version__ = "0.2.14"
10
+
11
+ #: One line, shown on every server start and on `mi-mcp setup` / `mi-mcp doctor`.
12
+ #: Goes to STDERR only: the server speaks MCP over stdout, and one stray byte
13
+ #: there breaks the host's JSON-RPC framing. [KASEY-STATED 2026-10-19] this is
14
+ #: the last release; the desktop app carries the local MCP from here on.
15
+ DEPRECATION_NOTICE = (
16
+ "mi-mcp (mi-local) is DEPRECATED and 0.2.14 is its final release. It keeps "
17
+ "working, but receives no further updates. Use the MemoryIntelligence desktop "
18
+ "app's built-in MCP (Connect Claude) on your computer, or the claude.ai "
19
+ "MemoryIntelligence connector on the web and phone. "
20
+ "Details: https://github.com/somewhere11/MemoryIntelligence/issues/2186"
21
+ )
22
+
23
+
24
+ def warn_deprecated(stream=None) -> None:
25
+ """Write :data:`DEPRECATION_NOTICE` to ``stream`` (default: stderr).
26
+
27
+ Written directly rather than through ``logging`` so it appears even when the
28
+ host runs the server with logging quietened, and never on stdout.
29
+ """
30
+ out = stream if stream is not None else sys.stderr
31
+ out.write(f"[mi-mcp] DEPRECATED: {DEPRECATION_NOTICE}\n")
32
+ out.flush()
@@ -20,7 +20,7 @@ import asyncio
20
20
  import logging
21
21
  import sys
22
22
 
23
- from . import __version__
23
+ from . import __version__, warn_deprecated
24
24
 
25
25
  logger = logging.getLogger("mi_mcp")
26
26
 
@@ -96,6 +96,11 @@ def main():
96
96
  # config/import reads as a silent "connected → 60s timeout" with no failure point.
97
97
  logger.info("mi-mcp %s starting…", __version__)
98
98
 
99
+ # #2186 — final release. Anyone who still has mi-local wired sees this in the
100
+ # host's MCP log on every start; nothing is removed and nothing changes shape.
101
+ # stderr only: stdout is the MCP transport.
102
+ warn_deprecated()
103
+
99
104
  # Load config from env (CLI args override env vars)
100
105
  from .config import MIConfig
101
106
 
@@ -38,7 +38,7 @@ import tempfile
38
38
  from dataclasses import dataclass
39
39
  from pathlib import Path
40
40
 
41
- from . import __version__, paths
41
+ from . import __version__, paths, warn_deprecated
42
42
  from .config import load_opt_in_paths
43
43
 
44
44
  # "mi-local" (#1320): the local stdio server's config id. It was
@@ -576,6 +576,7 @@ def _upgrade_command() -> str:
576
576
 
577
577
 
578
578
  def cmd_doctor(argv: list[str]) -> int:
579
+ warn_deprecated() # #2186 — final release; stderr, before anything else
579
580
  ap = argparse.ArgumentParser(prog="mi-mcp doctor")
580
581
  ap.add_argument("--home", default=os.environ.get("HOME"))
581
582
  ap.add_argument("--no-version-check", action="store_true",
@@ -1169,6 +1170,7 @@ def _opt_in_dir(home: Path, directory: str) -> tuple[Path, bool]:
1169
1170
 
1170
1171
 
1171
1172
  def cmd_setup(argv: list[str]) -> int:
1173
+ warn_deprecated() # #2186 — final release; stderr, before anything else
1172
1174
  ap = argparse.ArgumentParser(
1173
1175
  prog="mi-mcp setup",
1174
1176
  description="One command: store your key, wire hosts, opt in this dir, verify.",
@@ -168,6 +168,9 @@ def _shape_ask(result: Any, explain: Any = "none") -> Any:
168
168
  "umo_id": r.get("umo_id"),
169
169
  # content_text duplicates summary; fall back to it only if summary is empty.
170
170
  "summary": r.get("summary") or r.get("content_text"),
171
+ # The memory's stored title (API migration 079): its own on a
172
+ # memory, the parent memory's on a claim. Kept only when present.
173
+ **{k: r[k] for k in ("title", "memory_title") if r.get(k)},
171
174
  # #538: the API omits source when it's the default — absent means "api".
172
175
  "source": r.get("source") or "api",
173
176
  "score": r.get("score"),
@@ -186,10 +189,25 @@ def _shape_ask(result: Any, explain: Any = "none") -> Any:
186
189
  # level; drop the receipt's duplicate result seals (the hits already carry
187
190
  # them) and keep the fields an agent cites. Absent when receipts are
188
191
  # disabled server-side — then the shape is just {"results": [...]}.
192
+ # #1117: the answerability verdict, surfaced WITHOUT asking for explain.
193
+ # Every hit already carries a `score`, and on the CE scale ~94% of them read
194
+ # 0.0 (#2013) — so a junk row and a good row look identical to a reading
195
+ # model. `answerable` is the one field that separates them. It rides at the
196
+ # envelope level, next to results, because a model that has to opt in to the
197
+ # verdict will not.
198
+ #
199
+ # ADVISORY, deliberately: the rows are still here and a caller may cite them.
200
+ # This says what MI thinks, it does not withhold.
201
+ envelope: dict = {"results": shaped}
202
+ if isinstance(data.get("answerable"), bool):
203
+ envelope["answerable"] = data["answerable"]
204
+ if data.get("top_similarity") is not None:
205
+ envelope["top_similarity"] = data["top_similarity"]
206
+
189
207
  receipt = data.get("knowledge_receipt")
190
208
  if isinstance(receipt, dict):
191
209
  return {
192
- "results": shaped,
210
+ **envelope,
193
211
  "knowledge_receipt": {
194
212
  "receipt_id": receipt.get("receipt_id"),
195
213
  "question_hash": receipt.get("question_hash"),
@@ -198,7 +216,7 @@ def _shape_ask(result: Any, explain: Any = "none") -> Any:
198
216
  "versions": receipt.get("versions"),
199
217
  },
200
218
  }
201
- return {"results": shaped}
219
+ return envelope
202
220
 
203
221
 
204
222
  def _entity_tags(it: dict) -> list:
@@ -246,6 +264,7 @@ def _shape_list(result: Any) -> Any:
246
264
  continue
247
265
  shaped.append({
248
266
  "umo_id": it.get("umo_id"),
267
+ **{k: it[k] for k in ("title", "memory_title") if it.get(k)},
249
268
  "summary": it.get("summary"),
250
269
  "source": it.get("source"),
251
270
  "topics": it.get("topics"),
@@ -1,3 +0,0 @@
1
- """MI MCP Server — MemoryIntelligence tools for Claude."""
2
-
3
- __version__ = "0.2.13"