writenotenow/memory-journal-mcp

Memory Journal MCP Server

https://img.shields.io/badge/GitHub-neverinfamous/memory--journal--mcp-blue?logo=github](https://github.com/neverinfamous/memory-journal-mcp) https://img.shields.io/docker/pulls/writenotenow/memory-journal-mcp](https://hub.docker.com/r/writenotenow/memory-journal-mcp) https://img.shields.io/badge/License-MIT-blue.svg](https://opensource.org/licenses/MIT) !https://img.shields.io/badge/status-Production%2FStable-brightgreen https://img.shields.io/npm/v/memory-journal-mcp](https://www.npmjs.com/package/memory-journal-mcp) https://img.shields.io/badge/Security-Enhanced-green.svg](https://github.com/neverinfamous/memory-journal-mcp/blob/main/SECURITY.md) https://img.shields.io/github/stars/neverinfamous/memory-journal-mcp?style=social](https://github.com/neverinfamous/memory-journal-mcp) https://img.shields.io/badge/TypeScript-Strict-blue.svg](https://github.com/neverinfamous/memory-journal-mcp) !https://img.shields.io/badge/Coverage-96.7%25-brightgreen.svg !https://img.shields.io/badge/Tests-1782_passed-brightgreen.svg !https://img.shields.io/badge/E2E_Tests-377_passed-brightgreen.svg https://github.com/neverinfamous/memory-journal-mcp/actions/workflows/gatekeeper.yml/badge.svg](https://github.com/neverinfamous/memory-journal-mcp/actions/workflows/gatekeeper.yml)

🎯 AI上下文+项目智能：通过持久化项目记忆和自动会话交接连接断开的AI会话，并集成完整GitHub工作流。

https://github.com/neverinfamous/memory-journal-mcp • https://github.com/neverinfamous/memory-journal-mcp/wiki • https://github.com/neverinfamous/memory-journal-mcp/blob/main/CHANGELOG.md • 发布文章

🎯 功能介绍

核心优势

61个MCP工具 · 17个工作流提示 · 33个资源 · 10个工具组 · 代码模式 · GitHub指挥官（问题分类、PR审查、里程碑冲刺、安全/质量/性能审计） · GitHub集成（问题、PR、Actions、看板、里程碑、洞察） · 团队协作（共享数据库、向量搜索、跨项目洞察）

https://github.com/neverinfamous/memory-journal-mcp/wiki/Examples

---

建议规则（添加到AGENTS.md、GEMINI.md等）

聊天开始时始终执行：默认读取memory://briefing，并将userMessage以格式化项目符号列表的形式呈现给用户，包括所有可用字段。当用户提示或现有简报明确指示特定仓库时，额外读取该仓库的memory://briefing/{repo}。

在自然检查点创建日志条目：

• 推送到main后（milestone或technical_note，标记版本）
• 重大设计决策或学习后（project_decision）
• 解决非 trivial 错误后（bug_fix，链接问题编号）
• 条目应仅涵盖当前线程中完成的工作。

适当时使用项目和跨项目洞察：

• 在定义主要架构、新抽象或开始跨领域工作前，运行get_cross_project_insights以与更广泛的仓库模式保持一致。
• 获取memory://github/insights或运行get_repo_insights以评估项目牵引力、健康状况和近期流量。

注意到工作流机会时，建议创建或改进规则和技能。

---

工具过滤

[!IMPORTANT] 所有快捷方式和工具组默认包含代码模式（mj_execute_code）以实现令牌高效操作。要排除它，在过滤器中添加-codemode：--tool-filter starter,-codemode

通过MEMORY_JOURNAL_MCP_TOOL_FILTER（或CLI：--tool-filter）控制暴露哪些工具：

过滤器语法：快捷方式或组或工具名称（白名单模式）· -组（禁用组）· -工具（禁用工具）· +工具（组禁用后重新启用）

自定义选择：列出单个工具名称创建自己的白名单：--tool-filter "create_entry,search_entries,semantic_search"

组：core、search、analytics、relationships、export、admin、github、backup、team、codemode

https://github.com/neverinfamous/memory-journal-mcp/wiki/Tool-Filtering

📋 核心能力

🛠️ 61个MCP工具（10个组）

https://github.com/neverinfamous/memory-journal-mcp/wiki/Tools

🎯 17个工作流提示

站会、回顾、PR摘要、每周摘要、周期分析、里程碑跟踪、上下文捆绑、会话摘要等。https://github.com/neverinfamous/memory-journal-mcp/wiki/Prompts

📡 33个资源（20个静态 + 13个模板）

20个静态资源（memory://briefing、memory://workflows、memory://rules、memory://health、memory://help、memory://help/gotchas、GitHub状态/洞察、团队统计等）以及13个模板资源用于动态简报（memory://briefing/{repo}）、项目时间线、问题/PR条目、看板、里程碑详情、每个仓库的GitHub详情和每个组的帮助。https://github.com/neverinfamous/memory-journal-mcp/wiki/Resources

🚀 快速开始（2分钟）

前提条件：已安装并运行Docker · ~250MB磁盘空间 · https://github.com/neverinfamous/memory-journal-mcp/wiki/Installation

1. 拉取镜像

bash
docker pull writenotenow/memory-journal-mcp:latest

2. 创建数据目录

bash
mkdir data

3. 添加到MCP配置

添加到~/.cursor/mcp.json、Claude Desktop配置或等效配置中：

基本配置

json
{
  "mcpServers": {
    "memory-journal-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "./data:/app/data",
        "-e",
        "GITHUB_TOKEN",
        "-e",
        "PROJECT_REGISTRY={\"my-repo\":{\"path\":\"/app/repo\",\"project_number\":1}}",
        "-v",
        "/path/to/your/repo:/app/repo:ro",
        "writenotenow/memory-journal-mcp:latest"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

高级配置（推荐）

展示服务器全部功能，包括多项目路由、团队协作、Copilot认知和上下文注入。

json
{
  "mcpServers": {
    "memory-journal-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "./data:/app/data",
        "-e",
        "GITHUB_TOKEN",
        "-v",
        "/path/to/shared/team.db:/app/data/team.db:rw",
        "-v",
        "/path/to/your/projects:/app/projects:ro",
        "-v",
        "/path/to/rules.md:/app/rules.md:ro",
        "-v",
        "/path/to/skills:/app/skills:ro",
        "writenotenow/memory-journal-mcp:latest"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "TEAM_DB_PATH": "/app/data/team.db",
        "PROJECT_REGISTRY": "{\"my-repo\":{\"path\":\"/app/projects/repo1\",\"project_number\":1},\"other-repo\":{\"path\":\"/app/projects/repo2\",\"project_number\":5}}",
        "AUTO_REBUILD_INDEX": "true",
        "MEMORY_JOURNAL_MCP_TOOL_FILTER": "codemode",
        "BRIEFING_ENTRY_COUNT": "3",
        "BRIEFING_INCLUDE_TEAM": "true",
        "BRIEFING_ISSUE_COUNT": "1",
        "BRIEFING_PR_COUNT": "1",
        "BRIEFING_PR_STATUS": "true",
        "BRIEFING_WORKFLOW_COUNT": "1",
        "BRIEFING_WORKFLOW_STATUS": "true",
        "BRIEFING_COPILOT_REVIEWS": "true",
        "RULES_FILE_PATH": "/app/rules.md",
        "SKILLS_DIR_PATH": "/app/skills",
        "MEMORY_JOURNAL_WORKFLOW_SUMMARY": "/deploy: 生产部署 | /audit: 安全扫描"
      }
    }
  }
}

变体（修改上述配置）：

4. 重启并开始日志记录！

重启Cursor或MCP客户端，开始使用日志功能！

GitHub集成配置

GitHub工具（get_github_issues、get_github_prs等）在配置GITHUB_REPO_PATH时（如快速开始配置所示）会从git上下文中自动检测仓库。