← 返回目录

Memory Journal MCP Server

社区

跨 AI 会话的持久记忆与上下文衔接，深度融合 GitHub 工作流。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 15 / 438
Stars: ★ 20 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 4 个月前
工具数: 64

70FMRS · B

Memory Journal MCP Server 功能丰富，适合需要长期记忆与团队协作的开发者。安全性设计考虑周全，但需注意配置细节。

最强项 · 文档质量 17/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

15/20

维护活跃度

13/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 11/20: README声称1782个单元测试与391个E2E测试通过、90.53%覆盖率，并引用CI badge（gatekeeper.yml），但这是README自述证据，静态审查无法验证其真实性；声明73个工具、46个资源、19个提示词与结构化错误处理（{success,error,code,...}）设计合理，且工具过滤/只读契约/超时/速率限制等失败路径有描述，但无源码级执行证据，按静态校准不高于12，记11。
安全与权限 15/20: 无红线问题：未发现真实token、恶意行为或伪造身份。亮点包括：公共绑定0.0.0.0强制认证、OAuth 2.1（RFC 9728/8414）、路径边界ALLOWED_IO_ROOTS默认fail-closed、审计日志默认脱敏、令牌自动清除。扣分项：Code Mode沙箱依赖正则黑名单+冻结原型等启发式手段（worker_threads非真正多租户隔离），且提供CODEMODE_INTERNAL_FULL_ACCESS可绕过过滤；GITHUB_TOKEN以明文env存放为常见做法但文档未见最小权限细化；整体风险可见、防护较完整但依赖文档自述，记15。
维护活跃度 13/20: MIT许可证明确，版本8.0.1持续迭代，有SECURITY.md、CHANGELOG、CI badge、SBOM/构建溯源声明，README标注Production/Stable。但项目仅19星、7个开放issue，无实际issue响应记录、发布频率或依赖更新证据可静态验证，治理与安全响应流程仅为声明，记13。
文档质量 17/20: 文档层次完整：快速开始、环境变量全表、CLI标志、OAuth配置、HTTP端点、调度任务、基准与测试说明、Wiki链接、Mermaid架构图、配置预设与变体，且对限制（冷启动延迟、stdio调度器不生效、OAuth为opt-in、默认无认证）有披露。扣分在于所有证据均来自README自述（工具/资源/提示词数量、性能数据未经源码核实），缺少独立故障排查材料，记17。
安装易用性 14/20: 安装路径清晰：npm全局安装/Docker/源码三种方式，含主流客户端（Cursor、Claude Desktop）mcp.示例、npx变体、HTTP启动curl示例。扣分项：高级配置需大量环境变量（GITHUB_TOKEN、PROJECT_REGISTRY JSON、ALLOWED_IO_ROOTS等），语义搜索依赖~23MB模型下载存在网络冷启动，Docker挂载与共享团队库配置较复杂，记14。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络连接数据库

适合谁

需要长期记忆的大型项目开发团队的 AI 辅助工作流。
希望整合 IDE 代理与 GitHub Copilot 上下文的开发者。
需要跨多个仓库管理项目上下文的工程师。

不适合谁

不需要持久化记忆的简单临时任务。
要求完全无需配置的零功能用户。
不能接受 70+ 工具带来的工具列表过长的用户（可使用工具过滤功能）。

所需权限

本地文件系统：通过 ALLOWED_IO_ROOTS 限制访问路径，用于导入/导出和 Code Mode。
GitHub API 访问：需要 GITHUB_TOKEN 来访问议题、PR、Actions 等。
网络访问：用于 HTTP/SSE 传输时的远程连接、以及向量索引的远程调用（若使用）、OAuth 认证。
数据库文件读写：SQLite 数据库文件，通常位于本地目录。

风险与副作用

数据安全：虽然数据默认保存在本地，但如果配置不当，可能通过 ALLOWED_IO_ROOTS 暴露敏感文件访问路径。
GitHub 凭据风险：如果配置的 GITHUB_TOKEN 权限过大，可能导致泄露或被滥用。
沙箱逃逸：虽然 Code Mode 有多层防护，但任何代码执行都具有潜在风险，建议不要给不受信任的客户端使用。
传输安全：使用 HTTP/SSE 时若不启用 TLS（生产环境）和认证，会话可能被劫持。
依赖风险：使用第三方 embedding 模型可能引入未知漏洞。

安装接入

准备工作

运行环境：Node.js · Docker

GITHUB_TOKEN 可选密钥 GitHub 个人访问令牌，用于 Issues/PRs/Actions 等 GitHub API 访问，在 GitHub 设置中生成，需 repo、project、read:org 权限。

MCP_AUTH_TOKEN 可选密钥 HTTP 传输的 Bearer 令牌，公开绑定时必须设置。

其他可选配置项（55 个）

PROJECT_REGISTRY 可选 JSON 映射，将仓库名映射到本地路径和 GitHub Project 编号，用于多项目自动路由。

ALLOWED_IO_ROOTS 可选逗号分隔的绝对路径，限定导出/导入和 Code Mode 可访问的文件系统范围，默认拒绝访问。

DB_PATH 可选 SQLite 日志数据库文件的存储路径。

TEAM_DB_PATH 可选团队共享数据库路径，启用团队协作和 Hush Protocol 时需要。

TEAM_AUTHOR 可选覆盖团队条目的作者名，默认取 git config user.name。

DEFAULT_PROJECT_NUMBER 可选创建 issue 时自动分配的默认 GitHub Project 编号。

AUTO_REBUILD_INDEX 可选设为 true 时服务器启动时重建向量索引。

MCP_HOST 可选 HTTP 传输的绑定主机，容器环境设为 0.0.0.0。

MCP_CORS_ORIGIN 可选 HTTP 传输允许的 CORS 来源，逗号分隔，默认严格关闭。

TRUST_PROXY 可选是否信任代理头，用于限流和来源检查，默认 false。

PUBLIC_ORIGIN 可选 OAuth 重定向 URI 使用的公网来源地址。

MCP_RATE_LIMIT_MAX 可选每分钟每 IP 的最大请求数，仅 HTTP 模式，默认 100。

LOG_LEVEL 可选日志级别：error、warn、info、debug，默认 info。

MCP_ENABLE_HSTS 可选启用 HSTS 安全响应头，默认关闭。

OAUTH_ENABLED 可选设为 true 启用 OAuth 2.1 认证（仅 HTTP 模式）。

OAUTH_ISSUER 可选 OAuth 签发方 URL，例如 Keycloak realm 地址。

OAUTH_AUDIENCE 可选 JWT 校验的 audience 声明。

OAUTH_JWKS_URI 可选 JWKS 端点，用于 JWT 签名验证。

OAUTH_ALLOW_PLAINTEXT_LOOPBACK 可选允许本地 OAuth 客户端使用明文 HTTP 回环重定向 URI，默认 false。

OAUTH_CLOCK_TOLERANCE 可选 JWT 校验的时钟偏移容忍秒数，默认 5。

CODE_MODE_MAX_RESULT_SIZE 可选 mj_execute_code 结果载荷的最大字节数，默认 102400。

CODEMODE_INTERNAL_FULL_ACCESS 可选设为 true 时 Code Mode 沙箱内绕过工具过滤约束。

BRIEFING_ENTRY_COUNT 可选会话简报中包含的日志条目数量，默认 3。

BRIEFING_SUMMARY_COUNT 可选会话简报中包含的会话摘要数量，默认 1。

BRIEFING_INCLUDE_TEAM 可选是否在简报中包含团队数据库条目，默认 false。

BRIEFING_ISSUE_COUNT 可选简报中列出的 issue 数量，0 表示只显示计数。

BRIEFING_PR_COUNT 可选简报中列出的 PR 数量，0 表示只显示计数。

BRIEFING_PR_STATUS 可选是否在简报中显示 PR 状态分布，默认 false。

BRIEFING_MILESTONE_COUNT 可选简报中列出的里程碑数量，默认 3。

BRIEFING_WORKFLOW_COUNT 可选简报中列出的 workflow 运行数量，0 表示只显示状态。

BRIEFING_WORKFLOW_STATUS 可选是否在简报中显示 workflow 状态分布，默认 false。

BRIEFING_COPILOT_REVIEWS 可选是否在简报中汇总 Copilot 评审状态，默认 false。

RULES_FILE_PATH 可选用户规则文件路径，作为 memory://rules 资源暴露给 agent。

SKILLS_DIR_PATH 可选 agent 技能目录路径，作为 memory://skills 资源暴露。

MEMORY_JOURNAL_WORKFLOW_SUMMARY 可选 memory://workflows 资源显示的自由文本工作流摘要。

INSTRUCTION_LEVEL 可选简报行为指引详细程度：essential、standard（默认）、full。

PROJECT_LINT_CMD 可选 GitHub Commander 校验使用的 lint 命令，默认 npm run lint。

PROJECT_TYPECHECK_CMD 可选类型检查命令，默认 npm run typecheck。

PROJECT_BUILD_CMD 可选构建命令，默认 npm run build。

PROJECT_TEST_CMD 可选测试命令，默认 npm run test。

PROJECT_E2E_CMD 可选 E2E 测试命令，默认留空跳过。

PROJECT_PACKAGE_MANAGER 可选包管理器覆盖：npm、yarn、pnpm、bun，默认按 lockfile 自动检测。

PROJECT_HAS_DOCKERFILE 可选启用 Docker 审计步骤，默认自动检测。

COMMANDER_HITL_FILE_THRESHOLD 可选变更文件超过该数量时触发人工确认，默认 10。

COMMANDER_SECURITY_TOOLS 可选覆盖安全审计工具自动检测，逗号分隔。

COMMANDER_BRANCH_PREFIX 可选创建 PR 的分支名前缀，默认 fix。

AUDIT_LOG_PATH 可选 JSONL 审计日志路径，记录写/管理类工具调用，省略则禁用。

AUDIT_REDACT 可选默认 true 时对审计日志中的工具参数脱敏。

AUDIT_READS 可选设为 true 时同时记录读取类工具调用，默认 false。

AUDIT_LOG_MAX_SIZE 可选审计日志轮转前的最大字节数，默认 10485760。

MCP_METRICS_ENABLED 可选设为 false 禁用内存中的工具调用指标统计，默认 true。

FLAG_VOCABULARY 可选 Hush Protocol 的标记类型词汇，默认 blocker,needs_review,help_requested,fyi。

PRUNE_OLDER_THAN_DAYS 可选启动时软删除超过 N 天且重要性低的条目，0 表示禁用。

PRUNE_IMPORTANCE_THRESHOLD 可选重要性阈值（0.0–1.0），低于此分数的条目被清理，默认 0.15。

MEMORY_JOURNAL_MCP_TOOL_FILTER 可选控制暴露的工具集合，如 full、starter、readonly 或分组排除语法。

全局安装 npm 包：npm install -g memory-journal-mcp
在 MCP 客户端配置文件（如 Claude Desktop、Cursor）的 mcpServers 字段中添加配置。
根据需求设置环境变量，如 GITHUB_TOKEN、PROJECT_REGISTRY、ALLOWED_IO_ROOTS 等。
可选：使用 Docker: docker run -i --rm -v ./data:/app/data writenotenow/memory-journal-mcp:latest。
重启 MCP 客户端。

claude_desktop_config.json

{
  "mcpServers": {
    "memory-journal-mcp": {
      "command": "memory-journal-mcp",
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "PROJECT_REGISTRY": "{\"my-repo\":{\"path\":\"/path/to/your/git/repo\",\"project_number\":1}}",
        "ALLOWED_IO_ROOTS": "/path/to/your/git/repo"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "memory-journal-mcp": {
      "command": "memory-journal-mcp",
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "PROJECT_REGISTRY": "{\"my-repo\":{\"path\":\"/path/to/your/git/repo\",\"project_number\":1}}",
        "ALLOWED_IO_ROOTS": "/path/to/your/git/repo"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add memory-journal-mcp -e GITHUB_TOKEN=ghp_your_token_here -e 'PROJECT_REGISTRY={"my-repo":{"path":"/path/to/your/git/repo","project_number":1}}' -e ALLOWED_IO_ROOTS=/path/to/your/git/repo -- memory-journal-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后在客户端工具列表中应能看到 create_entry、search_entries 等工具；也可以让 AI 读取 memory://briefing 资源，若能返回项目简报即说明连接成功。

常见排障

确保 MCP 客户端支持 MCP 协议，并正确配置了 'command' 和 'args'。
检查环境变量是否正确设置，特别是 GITHUB_TOKEN、ALLOWED_IO_ROOTS 等。
对于多项目配置，确保 PROJECT_REGISTRY 格式正确，且路径为实际存在的文件系统路径。
如果向量搜索失败，检查是否已设置 AUTO_REBUILD_INDEX=true 或手动调用 rebuild_vector_index。
在 HTTP 传输模式中，确保使用正确的端口和 endpoints，并且认证已正确启用。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我搜索上个月关于 SQLite 和 Postgres 选型的讨论记录。
看看当前仓库的看板，把最优先的工单整理成一份分诊建议。
给 @sarah 提一个 blocker 标记，说明数据库报错阻碍了进度。
为最近 10 条架构决策生成一张关系图。

工具能力 64

create_entry 写入

创建一条新的日志条目。

get_entry 只读

根据 ID 获取单条日志条目。

get_recent_entries 只读

获取最近的日志条目。

update_entry 写入

更新日志条目的内容或元数据。

delete_entry 破坏性

逻辑删除日志条目。

list_tags 只读

列出所有标签及其使用次数。

merge_tags 写入

将多个标签合并为一个。

tag_entries 写入

为条目添加或移除标签。

展开其余 56 个工具

search_entries 只读

使用全文搜索（FTS5）或模糊匹配查询日志。

semantic_search 只读

基于语义相似度执行向量搜索。

date_range_search 只读

结合日期范围和关键词搜索。

get_vector_stats 只读

查看向量索引统计信息。

get_statistics 只读

获取日志数据库的统计概要。

get_cross_project_insights 只读

获取跨项目洞察。

link_entries 写入

在两个条目之间创建关系链接。

get_relationship_graph 只读

生成知识图谱（Mermaid 图表格式）。

export_json

将日志数据导出为 JSON。

import_json

从 JSON 导入日志数据。

export_markdown 只读

将日志条目导出为 Markdown。

import_markdown 写入

从 Markdown 文件导入日志数据。

rebuild_vector_index 写入

重建整个向量索引。

add_to_vector_index 写入

向向量索引中添加或更新条目。

get_github_issues 只读

获取 GitHub 仓库的议题列表。

get_github_issue 只读

获取单个议题详情。

get_github_prs 只读

获取 Pull Request 列表。

get_github_pr 只读

获取单个 PR 详情。

get_github_context 只读

获取完整的仓库上下文（包括 CI 状态、未发布变更等）。

get_kanban_board 只读

获取 GitHub Project 看板内容。

add_kanban_item 写入

向看板添加新卡片。

move_kanban_item 写入

移动看板卡片到其他列。

delete_kanban_item 破坏性

删除看板卡片。

get_github_milestones 只读

获取里程碑列表及完成率。

get_github_milestone 只读

获取单个里程碑详情。

create_github_milestone 写入

创建里程碑。

update_github_milestone 写入

更新里程碑信息。

delete_github_milestone 破坏性

删除里程碑。

get_repo_insights 只读

获取仓库 14 天流量和统计洞察。

create_github_issue_with_entry 写入

创建议题并自动关联日志条目。

close_github_issue_with_entry 写入

关闭议题并自动记录日志。

get_github_actions 只读

获取 GitHub Actions 工作流运行记录。

get_github_workflows 只读

获取工作流定义列表。

backup_database 写入

备份日志数据库。

list_backups 只读

列出所有备份文件。

restore_database 破坏性

恢复数据库备份。

cleanup_backups 破坏性

清理过期的备份文件。

team_create_entry 写入

在团队数据库中创建条目。

team_get_entry 只读

获取团队数据库中的条目。

team_update_entry 写入

更新团队数据库中的条目。

team_delete_entry 破坏性

删除团队数据库中的条目。

team_search 只读

在团队数据库中进行全文搜索。

team_semantic_search 只读

在团队数据库中进行语义搜索。

team_get_stats 只读

获取团队数据库统计信息。

team_link_entries 写入

关联团队数据库中的条目。

team_get_relationship_graph 只读

生成团队条目的关系图谱。

team_export_markdown 只读

导出团队数据为 Markdown。

team_import_markdown 写入

从 Markdown 导入团队数据。

team_backup 写入

备份团队数据库。

team_restore 破坏性

恢复团队数据库。

team_list_flags 只读

列出 Hush 协议的活跃标志。

team_update_flag 写入

更新标志的元数据或状态。

team_resolve_flag 写入

解决或关闭标志。

team_pass_flag 写入

创建新的 Hush 协议标志。

team_get_flag_analytics 只读

获取标志解析速度和工作量统计。

mj_execute_code 写入

在沙箱环境中执行 JavaScript 代码，访问所有 mj API，实现多步操作。

使用场景

保留项目开发过程中跨 AI 会话的关键决策和历史上下文，避免 AI 每次从零开始。

自动生成会话摘要，并在下一次会话开始时自动加载简报，实现无缝衔接。

管理 GitHub 议题、PR、里程碑和看板，并将工作记录与日志关联。

团队共享知识库，支持异步协作，通过 Hush 协议标志和向量搜索跨成员共享信息。

生成项目时间线、状态报告等可视化分析。

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Memory Journal MCP Server 是一款为 AI 代理提供项目级长期记忆的 MCP 服务器。它通过可持久化的知识图谱，在 AI 会话之间无缝传递上下文，终结 "AI 失忆症"。内置 GitHub 集成（议题、PR、Actions、看板、里程碑等）、动态项目识别、多功能混合搜索（关键词+语义+时间过滤）、知识图谱可视化、团队协作（共享数据库+向量搜索+跨项目洞察）、Hush 协议（异步标志）和自适应会话简报等功能。提供 70+ 工具、19 个提示词、46 个资源，支持 Code Mode 以大幅节省 Token。采用 TypeScript 编写，基于 SQLite 和本地 embedding 模型，数据本地优先，全程可控。