io.github.neverinfamous/memory-journal-mcp

Developer journal with knowledge graphs, relationships, Git context, and semantic search

ā˜… 13MITdevtools

Install

Config snippet generator goes here (5 client tabs)

README

# Memory Journal MCP Server

<!-- mcp-name: io.github.neverinfamous/memory-journal-mcp -->

[![GitHub](https://img.shields.io/badge/GitHub-neverinfamous/memory--journal--mcp-blue?logo=github)](https://github.com/neverinfamous/memory-journal-mcp)
[![npm](https://img.shields.io/npm/v/memory-journal-mcp)](https://www.npmjs.com/package/memory-journal-mcp)
[![Docker Pulls](https://img.shields.io/docker/pulls/writenotenow/memory-journal-mcp)](https://hub.docker.com/r/writenotenow/memory-journal-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
![Status](https://img.shields.io/badge/status-Production%2FStable-brightgreen)
[![MCP Registry](https://img.shields.io/badge/MCP_Registry-Published-green)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.neverinfamous/memory-journal-mcp)
[![Security](https://img.shields.io/badge/Security-Enhanced-green.svg)](SECURITY.md)
[![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue.svg)](https://github.com/neverinfamous/memory-journal-mcp)
![Coverage](https://img.shields.io/badge/Coverage-96%25-brightgreen.svg)
![Tests](https://img.shields.io/badge/Tests-1767_passed-brightgreen.svg)
![E2E Tests](https://img.shields.io/badge/E2E_Tests-377_passed-brightgreen.svg)

šŸŽÆ **AI Context + Project Intelligence:** Bridge disconnected AI sessions with persistent project memory and **automatic session handoff** ā€” with full GitHub workflow integration.

**[GitHub](https://github.com/neverinfamous/memory-journal-mcp)** ā€¢ **[Wiki](https://github.com/neverinfamous/memory-journal-mcp/wiki)** ā€¢ **[Changelog](https://github.com/neverinfamous/memory-journal-mcp/blob/main/CHANGELOG.md)** ā€¢ **[Release Article](https://adamic.tech/articles/memory-journal-mcp-server)**

**šŸš€ Quick Deploy:**

- **[npm Package](https://www.npmjs.com/package/memory-journal-mcp)** - `npm install -g memory-journal-mcp`
- **[Docker Hub](https://hub.docker.com/r/writenotenow/memory-journal-mcp)** - Alpine-based with full semantic search

## šŸŽÆ What This Does

### What Sets Us Apart

**61 MCP Tools** Ā· **16 Workflow Prompts** Ā· **28 Resources** Ā· **10 Tool Groups** Ā· **Code Mode** Ā· **GitHub Commander** (Issue Triage, PR Review, Milestone Sprints, Security/Quality/Perf Audits) Ā· **GitHub Integration** (Issues, PRs, Actions, Kanban, Milestones, Insights) Ā· **Team Collaboration** (Shared DB, Vector Search, Cross-Project Insights)

| Feature                       | Description                                                                                                                                                    |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Session Intelligence**      | Agents auto-query project history, create entries at checkpoints, and hand off context between sessions via `/session-summary`                                 |
| **GitHub Integration**        | 16 tools for Issues, PRs, Actions, Kanban, Milestones (%), Copilot Reviews, and 14-day Insights                                                                |
| **Knowledge Graphs**          | 8 relationship types linking specs ā†’ implementations ā†’ tests ā†’ PRs with Mermaid visualization                                                                  |
| **Triple Search**             | Full-text (FTS5), semantic (`@huggingface/transformers` + `sqlite-vec`), and date-range search                                                                 |
| **Code Mode**                 | Execute multi-step operations in a secure sandbox ā€” up to 90% token savings via `mj.*` API                                                                     |
| **Configurable Briefing**     | 12 env vars / CLI flags control `memory://briefing` content ā€” entries, team, GitHub detail, skills awareness                                                   |
| **Reports & Analytics**       | Standups, retrospectives, PR summaries, digests, period analyses, and milestone tracking                                                                       |
| **Team Collaboration**        | 20 tools with full parity ā€” CRUD, vector search, relationship graphs, cross-project insights, author attribution                                               |
| **Backup & Restore**          | One-command backup/restore with automated scheduling, retention policies, and safety-net auto-backups                                                          |
| **Security & Transport**      | OAuth 2.1 (RFC 9728/8414, JWT/JWKS, scopes), Streamable HTTP + SSE, rate limiting, CORS, SQL injection prevention, non-root Docker                             |
| **Structured Error Handling** | Every tool returns `{success, error, code, category, suggestion, recoverable}` ā€” agents get classification, remediation hints, and recoverability signals      |
| **Agent Collaboration