适合谁
- 需要长期记忆的大型项目开发团队的 AI 辅助工作流。
- 希望整合 IDE 代理与 GitHub Copilot 上下文的开发者。
- 需要跨多个仓库管理项目上下文的工程师。
M
70FMRS · B
Memory Journal MCP Server 功能丰富，适合需要长期记忆与团队协作的开发者。安全性设计考虑周全，但需注意配置细节。
Memory Journal MCP Server 是一款为 AI 代理提供项目级长期记忆的 MCP 服务器。它通过可持久化的知识图谱，在 AI 会话之间无缝传递上下文，终结 "AI 失忆症"。内置 GitHub 集成（议题、PR、Actions、看板、里程碑等）、动态项目识别、多功能混合搜索（关键词+语义+时间过滤）、知识图谱可视化、团队协作（共享数据库+向量搜索+跨项目洞察）、Hush 协议（异步标志）和自适应会话简报等功能。提供 70+ 工具、19 个提示词、46 个资源，支持 Code Mode 以大幅节省 Token。采用 TypeScript 编写，基于 SQLite 和本地 embedding 模型，数据本地优先，全程可控。
工具能力
create_entry
创建一条新的日志条目。
get_entry
根据 ID 获取单条日志条目。
get_recent_entries
获取最近的日志条目。
update_entry
更新日志条目的内容或元数据。
delete_entry
逻辑删除日志条目。
list_tags
列出所有标签及其使用次数。
merge_tags
将多个标签合并为一个。
tag_entries
为条目添加或移除标签。
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，实现多步操作。
安装接入
- 全局安装 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"
}
}
}
}
选型与风险
不适合谁
- 不需要持久化记忆的简单临时任务。
- 要求完全无需配置的零功能用户。
- 不能接受 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 模型可能引入未知漏洞。
常见排障
- 确保 MCP 客户端支持 MCP 协议，并正确配置了 'command' 和 'args'。
- 检查环境变量是否正确设置，特别是 GITHUB_TOKEN、ALLOWED_IO_ROOTS 等。
- 对于多项目配置，确保 PROJECT_REGISTRY 格式正确，且路径为实际存在的文件系统路径。
- 如果向量搜索失败，检查是否已设置 AUTO_REBUILD_INDEX=true 或手动调用 rebuild_vector_index。
- 在 HTTP 传输模式中，确保使用正确的端口和 endpoints，并且认证已正确启用。
使用场景
保留项目开发过程中跨 AI 会话的关键决策和历史上下文，避免 AI 每次从零开始。
自动生成会话摘要，并在下一次会话开始时自动加载简报，实现无缝衔接。
管理 GitHub 议题、PR、里程碑和看板，并将工作记录与日志关联。
团队共享知识库，支持异步协作，通过 Hush 协议标志和向量搜索跨成员共享信息。
生成项目时间线、状态报告等可视化分析。
支持客户端
Claude Desktop完整支持
Cursor完整支持