Skip to content

docs(mcp): add mneme-memory README and bump to 0.1.2 - #398

Merged
modusensus merged 1 commit into
mainfrom
docs/mcp-readme
Oct 9, 2026
Merged

modusensus merged 1 commit into
mainfrom
docs/mcp-readme

Conversation

@modusensus

@modusensus modusensus commented Oct 9, 2026 •

Copy link
Copy Markdown
Collaborator

Problem

mneme-memory had no README at all — npm view mneme-memory readme returns "No README data found", so the npm page shows only the one-line description. For a package whose entire purpose is being discovered by MCP users on npm, that is the biggest gap on the listing.

Change

  • Add mcp/README.md: English-first with a mirrored Chinese section (repo bilingual convention).
  • Covers: the six tools; the reachable-library prerequisite (DSH external API, or dsh-mneme-serve without DSH, including the shared-port caveat); mount snippets; config resolution order with the MNEME_* aliases kept for pre-split mounts; the one scope-semantics difference (no session context, explicit agent_scope / workspace_scope only); security notes (single-writer API path, plain-HTTP warning, stderr-only logs).
  • Bump 0.1.1 → 0.1.2 in mcp/package.json and mcp/server.json (both version fields), since the README is the reason to republish.

Verification

  • npm pack --dry-run in mcp/: README.md (5.2 kB) now in the tarball, total files 3 → 6.
  • Every factual claim checked against source: bin name mneme-mcp vs package name (mcp/package.json), DEFAULT_URL = http://127.0.0.1:8790 and ~/.dsh-mneme/cli.json (mcp/bin/mneme-mcp.mjs:37-38), alias priority (:81-82), plain-HTTP warning and stderr-only logging, and the daemon's stdout listening line / stderr logs (dsh-mneme/bin/dsh-mneme-serve.mjs:8-12).
  • The npx example deliberately passes -p mneme-memory: bare npx mneme-mcp would try to install a nonexistent package (same trap the panel's serve card locks against).

Publishing 0.1.2 is a manual step (no workflow covers mcp/). Paired with #398, which wires the parity lock this README claims into CI.

Summary by CodeRabbit

  • 文档
    • 新增中文使用说明,介绍记忆工具、记忆库配置、MCP 客户端接入方式,以及相关配置和写入行为。
  • 版本更新
    • 服务器和 npm 包版本更新至 0.1.2。

The package page had no README at all (npm reports "No README data
found"), which is the main discovery surface for a package meant to be
found by strangers on npm. Content is English-first with a mirrored
Chinese section.

Covers: the six tools, the reachable-library prerequisite (external API
or dsh-mneme-serve, including the shared-port caveat), mount snippets,
config resolution order with the MNEME_* aliases kept for pre-split
mounts, the one scope-semantics difference, and the security notes
(single-writer API path, plain-HTTP warning, stderr-only logs).

The npx example passes `-p mneme-memory` on purpose: the bin name
differs from the package name, so a bare npx would try to install a
nonexistent package.
Copilot AI lite review requested due to automatic review settings October 9, 2026 21:04

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@coderabbitai

coderabbitai Bot commented Oct 9, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Repository: slow-stack/mneme/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: a6ad7f1b-d9fd-4a3f-be7b-5b381b965ac2

📥 Commits

Reviewing files that changed from the base of the PR and between 7545221 and 7c8af72.


📒 Files selected for processing (3)
  • mcp/README.md
  • mcp/package.json
  • mcp/server.json

Included review availability: This review used your included allowance. Your plan provides up to 2 included reviews per hour; 0 remain after this review.



📝 Walkthrough

Walkthrough

新增 mneme-memory MCP 服务文档,说明六种记忆工具、客户端挂载方式、连接配置及传输行为。npm 包和服务器元数据的版本均更新为 0.1.2。

Changes

MCP 服务更新

层 / 文件 摘要
服务使用说明与版本元数据
mcp/README.md, mcp/package.json, mcp/server.json
README 介绍六种记忆工具、记忆库前置条件、客户端配置、URL 和 token 的读取优先级、memory_save 的归属规则及传输说明。npm 包和服务器元数据版本从 0.1.1 更新为 0.1.2。

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~4 minutes

Change: Other


Merge Risk: ⚪ Minimal · up to 7c8af

The setup guidance matches the available UI and implementation evidence, and the release metadata is consistent. No material merge-blocking issue is identified.

Pre-merge checks | Passed 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed 标题准确概括了主要变更:新增 mneme-memory README,并将版本更新到 0.1.2。标题简洁、具体且与变更内容一致。
Docstring Coverage Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.


✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR


  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@codecov

codecov Bot commented Oct 9, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@modusensus
modusensus merged commit 08d95f2 into main Oct 9, 2026
11 checks passed
@modusensus
modusensus deleted the docs/mcp-readme branch October 9, 2026 21:16
@modusensus

Copy link
Copy Markdown
Collaborator Author

更正:正文末行的交叉引用写错了编号——与之配对的是 #397(把跨包平价锁接进 CI),不是本 PR 自身。README 里「a cross-package parity test locks this in CI」那句随 #397 合并已成立。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants