memory-journal-mcp 6.1.2 → 6.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -28
- package/dist/{chunk-X4SWFATC.js → chunk-BI4ZNSKA.js} +38 -24
- package/dist/{chunk-HCEWINSB.js → chunk-N6EBIDN7.js} +99 -102
- package/dist/cli.js +2 -2
- package/dist/index.js +2 -2
- package/dist/tools-WPRY5MJ6.js +2 -0
- package/package.json +10 -1
- package/skills/github-commander/SKILL.md +151 -0
- package/skills/github-commander/config/project-config.example.md +125 -0
- package/skills/github-commander/workflows/code-quality-audit.md +80 -0
- package/skills/github-commander/workflows/full-audit.md +134 -0
- package/skills/github-commander/workflows/issue-triage.md +239 -0
- package/skills/github-commander/workflows/milestone-sprint.md +81 -0
- package/skills/github-commander/workflows/perf-audit.md +142 -0
- package/skills/github-commander/workflows/pr-review.md +123 -0
- package/skills/github-commander/workflows/security-audit.md +170 -0
- package/skills/github-commander/workflows/update-deps.md +109 -0
- package/.dockerignore +0 -139
- package/.gitattributes +0 -20
- package/.github/ISSUE_TEMPLATE/bug_report.md +0 -95
- package/.github/ISSUE_TEMPLATE/config.yml +0 -11
- package/.github/ISSUE_TEMPLATE/feature_request.md +0 -110
- package/.github/ISSUE_TEMPLATE/question.md +0 -78
- package/.github/aw/actions-lock.json +0 -14
- package/.github/copilot-instructions.md +0 -122
- package/.github/dependabot.yml +0 -93
- package/.github/pull_request_template.md +0 -135
- package/.github/workflows/README.md +0 -133
- package/.github/workflows/agentics-maintenance.yml +0 -141
- package/.github/workflows/auto-release.yml +0 -68
- package/.github/workflows/ci-health-monitor.lock.yml +0 -1121
- package/.github/workflows/ci-health-monitor.md +0 -87
- package/.github/workflows/codeql.yml +0 -41
- package/.github/workflows/dependabot-auto-merge.yml +0 -42
- package/.github/workflows/dependency-maintenance.lock.yml +0 -1182
- package/.github/workflows/dependency-maintenance.md +0 -147
- package/.github/workflows/docker-publish.yml +0 -254
- package/.github/workflows/docs-drift-detector.lock.yml +0 -1142
- package/.github/workflows/docs-drift-detector.md +0 -115
- package/.github/workflows/lint-and-test.yml +0 -60
- package/.github/workflows/publish-npm.yml +0 -85
- package/.github/workflows/secrets-scanning.yml +0 -32
- package/.github/workflows/security-update.yml +0 -127
- package/.gitleaks.toml +0 -9
- package/.prettierignore +0 -21
- package/.prettierrc +0 -33
- package/.scout-ignore +0 -12
- package/.trivyignore +0 -21
- package/CHANGELOG.md +0 -1814
- package/CODE_OF_CONDUCT.md +0 -133
- package/CONTRIBUTING.md +0 -263
- package/DOCKER_README.md +0 -331
- package/Dockerfile +0 -128
- package/SECURITY.md +0 -227
- package/UNRELEASED.md +0 -1
- package/dist/tools-T4U5A3X4.js +0 -2
- package/docker-compose.yml +0 -71
- package/docs/README.md +0 -18
- package/docs/agentic-journal-synergy.md +0 -175
- package/docs/copilot-setup.md +0 -72
- package/eslint.config.js +0 -110
- package/mcp-config-example.json +0 -21
- package/playwright.config.ts +0 -35
- package/releases/v2.1.0.md +0 -220
- package/releases/v2.2.0.md +0 -168
- package/releases/v3.0.0.md +0 -237
- package/releases/v3.1.0.md +0 -104
- package/releases/v3.1.1.md +0 -42
- package/releases/v3.1.2.md +0 -40
- package/releases/v3.1.3.md +0 -64
- package/releases/v3.1.4.md +0 -32
- package/releases/v3.1.5.md +0 -44
- package/releases/v4.0.0.md +0 -71
- package/releases/v4.1.0.md +0 -88
- package/releases/v4.2.0.md +0 -90
- package/releases/v4.3.0.md +0 -92
- package/releases/v4.3.1.md +0 -69
- package/releases/v4.4.0.md +0 -120
- package/releases/v4.4.1.md +0 -33
- package/releases/v4.4.2.md +0 -31
- package/releases/v4.5.0.md +0 -116
- package/releases/v5.0.0.md +0 -105
- package/releases/v5.0.1.md +0 -25
- package/releases/v5.1.0.md +0 -83
- package/releases/v5.1.1.md +0 -10
- package/releases/v6.0.0.md +0 -48
- package/releases/v6.0.1.md +0 -36
- package/releases/v6.1.0.md +0 -68
- package/releases/v6.1.1.md +0 -30
- package/releases/v6.1.2.md +0 -23
- package/scripts/generate-server-instructions.ts +0 -306
- package/scripts/server-instructions-function-body.ts +0 -107
- package/scripts/server-instructions-gotchas.ts +0 -45
- package/server.json +0 -42
- package/social-preview.png +0 -0
- package/src/auth/auth-context.ts +0 -78
- package/src/auth/authorization-server-discovery.ts +0 -263
- package/src/auth/errors.ts +0 -215
- package/src/auth/index.ts +0 -58
- package/src/auth/middleware.ts +0 -392
- package/src/auth/oauth-resource-server.ts +0 -170
- package/src/auth/scope-map.ts +0 -46
- package/src/auth/scopes.ts +0 -256
- package/src/auth/token-validator.ts +0 -293
- package/src/auth/transport-agnostic.ts +0 -164
- package/src/auth/types.ts +0 -372
- package/src/cli.ts +0 -279
- package/src/codemode/api-constants.ts +0 -263
- package/src/codemode/api.ts +0 -302
- package/src/codemode/auto-return.ts +0 -65
- package/src/codemode/index.ts +0 -47
- package/src/codemode/sandbox-factory.ts +0 -144
- package/src/codemode/sandbox.ts +0 -220
- package/src/codemode/security.ts +0 -155
- package/src/codemode/types.ts +0 -228
- package/src/codemode/worker-sandbox.ts +0 -277
- package/src/codemode/worker-script.ts +0 -239
- package/src/constants/icons.ts +0 -183
- package/src/constants/server-instructions.md +0 -166
- package/src/constants/server-instructions.ts +0 -514
- package/src/database/adapter-factory.ts +0 -16
- package/src/database/core/entry-columns.ts +0 -10
- package/src/database/core/interfaces.ts +0 -188
- package/src/database/core/schema.ts +0 -152
- package/src/database/sqlite-adapter/backup.ts +0 -167
- package/src/database/sqlite-adapter/entries/crud.ts +0 -233
- package/src/database/sqlite-adapter/entries/importance.ts +0 -76
- package/src/database/sqlite-adapter/entries/index.ts +0 -142
- package/src/database/sqlite-adapter/entries/search.ts +0 -294
- package/src/database/sqlite-adapter/entries/shared.ts +0 -102
- package/src/database/sqlite-adapter/entries/statistics.ts +0 -162
- package/src/database/sqlite-adapter/index.ts +0 -265
- package/src/database/sqlite-adapter/native-connection.ts +0 -301
- package/src/database/sqlite-adapter/relationships.ts +0 -70
- package/src/database/sqlite-adapter/tags.ts +0 -182
- package/src/filtering/tool-filter.ts +0 -312
- package/src/github/github-integration/client.ts +0 -114
- package/src/github/github-integration/index.ts +0 -297
- package/src/github/github-integration/insights.ts +0 -155
- package/src/github/github-integration/issues.ts +0 -213
- package/src/github/github-integration/milestones.ts +0 -262
- package/src/github/github-integration/projects.ts +0 -414
- package/src/github/github-integration/pull-requests.ts +0 -235
- package/src/github/github-integration/repository.ts +0 -110
- package/src/github/github-integration/types.ts +0 -43
- package/src/handlers/prompts/github.ts +0 -210
- package/src/handlers/prompts/index.ts +0 -97
- package/src/handlers/prompts/workflow.ts +0 -361
- package/src/handlers/resources/core/briefing/context-section.ts +0 -182
- package/src/handlers/resources/core/briefing/github-section.ts +0 -354
- package/src/handlers/resources/core/briefing/index.ts +0 -106
- package/src/handlers/resources/core/briefing/user-message.ts +0 -114
- package/src/handlers/resources/core/health.ts +0 -75
- package/src/handlers/resources/core/index.ts +0 -31
- package/src/handlers/resources/core/instructions.ts +0 -45
- package/src/handlers/resources/core/utilities.ts +0 -310
- package/src/handlers/resources/github.ts +0 -340
- package/src/handlers/resources/graph.ts +0 -218
- package/src/handlers/resources/help.ts +0 -410
- package/src/handlers/resources/index.ts +0 -143
- package/src/handlers/resources/shared.ts +0 -219
- package/src/handlers/resources/team.ts +0 -134
- package/src/handlers/resources/templates.ts +0 -334
- package/src/handlers/tools/admin.ts +0 -351
- package/src/handlers/tools/analytics.ts +0 -346
- package/src/handlers/tools/backup.ts +0 -272
- package/src/handlers/tools/codemode.ts +0 -188
- package/src/handlers/tools/core.ts +0 -359
- package/src/handlers/tools/error-fields-mixin.ts +0 -10
- package/src/handlers/tools/export.ts +0 -150
- package/src/handlers/tools/github/copilot-tools.ts +0 -72
- package/src/handlers/tools/github/helpers.ts +0 -125
- package/src/handlers/tools/github/insights-tools.ts +0 -112
- package/src/handlers/tools/github/issue-tools.ts +0 -442
- package/src/handlers/tools/github/kanban-tools.ts +0 -153
- package/src/handlers/tools/github/milestone-tools.ts +0 -371
- package/src/handlers/tools/github/mutation-tools.ts +0 -17
- package/src/handlers/tools/github/read-tools.ts +0 -302
- package/src/handlers/tools/github/schemas.ts +0 -435
- package/src/handlers/tools/github.ts +0 -39
- package/src/handlers/tools/index.ts +0 -255
- package/src/handlers/tools/relationships.ts +0 -390
- package/src/handlers/tools/schemas.ts +0 -165
- package/src/handlers/tools/search.ts +0 -448
- package/src/handlers/tools/team/admin-tools.ts +0 -164
- package/src/handlers/tools/team/analytics-tools.ts +0 -233
- package/src/handlers/tools/team/backup-tools.ts +0 -83
- package/src/handlers/tools/team/core-tools.ts +0 -197
- package/src/handlers/tools/team/export-tools.ts +0 -130
- package/src/handlers/tools/team/helpers.ts +0 -66
- package/src/handlers/tools/team/index.ts +0 -45
- package/src/handlers/tools/team/relationship-tools.ts +0 -219
- package/src/handlers/tools/team/schemas.ts +0 -558
- package/src/handlers/tools/team/search-tools.ts +0 -145
- package/src/handlers/tools/team/vector-tools.ts +0 -261
- package/src/index.ts +0 -57
- package/src/server/mcp-server.ts +0 -446
- package/src/server/registration.ts +0 -141
- package/src/server/scheduler.ts +0 -283
- package/src/transports/http/handlers.ts +0 -78
- package/src/transports/http/index.ts +0 -8
- package/src/transports/http/security.ts +0 -147
- package/src/transports/http/server/index.ts +0 -397
- package/src/transports/http/server/legacy-sse.ts +0 -87
- package/src/transports/http/server/stateful.ts +0 -222
- package/src/transports/http/server/stateless.ts +0 -42
- package/src/transports/http/types.ts +0 -132
- package/src/types/entities.ts +0 -145
- package/src/types/error-types.ts +0 -92
- package/src/types/errors.ts +0 -200
- package/src/types/filtering.ts +0 -55
- package/src/types/github.ts +0 -216
- package/src/types/index.ts +0 -348
- package/src/utils/error-helpers.ts +0 -78
- package/src/utils/errors/error-response-fields.ts +0 -29
- package/src/utils/errors/suggestions.ts +0 -94
- package/src/utils/github-helpers.ts +0 -33
- package/src/utils/logger.ts +0 -107
- package/src/utils/mcp-logger.ts +0 -155
- package/src/utils/progress-utils.ts +0 -100
- package/src/utils/query-helpers.ts +0 -78
- package/src/utils/resource-annotations.ts +0 -75
- package/src/utils/security-utils.ts +0 -198
- package/src/utils/vector-index-helpers.ts +0 -24
- package/src/vector/vector-search-manager.ts +0 -409
- package/src/version.ts +0 -15
- package/test-server/README.md +0 -193
- package/test-server/code-map.md +0 -399
- package/test-server/test-agent-experience.md +0 -213
- package/test-server/test-filter-instructions.mjs +0 -295
- package/test-server/test-instruction-levels.mjs +0 -102
- package/test-server/test-preflight.md +0 -55
- package/test-server/test-prompts.mjs +0 -185
- package/test-server/test-scheduler.mjs +0 -174
- package/test-server/test-tool-annotations.mjs +0 -115
- package/test-server/test-tools-codemode.md +0 -632
- package/test-server/test-tools-codemode2.md +0 -1218
- package/test-server/test-tools-team.md +0 -215
- package/test-server/test-tools.md +0 -429
- package/test-server/test-tools2.md +0 -361
- package/test-server/test-tools3.md +0 -396
- package/test-server/tool-reference.md +0 -231
- package/tests/README.md +0 -54
- package/tests/auth/auth-context.test.ts +0 -162
- package/tests/auth/authorization-server-discovery.test.ts +0 -265
- package/tests/auth/errors.test.ts +0 -170
- package/tests/auth/middleware.test.ts +0 -585
- package/tests/auth/oauth-resource-server.test.ts +0 -173
- package/tests/auth/scope-map.test.ts +0 -66
- package/tests/auth/scopes.test.ts +0 -347
- package/tests/auth/token-validator.test.ts +0 -271
- package/tests/codemode/api.test.ts +0 -396
- package/tests/codemode/auto-return.test.ts +0 -167
- package/tests/codemode/codemode-tool-handlers.test.ts +0 -197
- package/tests/codemode/sandbox-factory.test.ts +0 -152
- package/tests/codemode/sandbox.test.ts +0 -190
- package/tests/codemode/security.test.ts +0 -242
- package/tests/codemode/worker-sandbox.test.ts +0 -106
- package/tests/constants/icons.test.ts +0 -101
- package/tests/constants/server-instructions.test.ts +0 -514
- package/tests/database/crud-workflow-branches.test.ts +0 -418
- package/tests/database/database-branches.test.ts +0 -132
- package/tests/database/entries-auth-branches.test.ts +0 -390
- package/tests/database/native-connection.test.ts +0 -249
- package/tests/database/shared-helpers.test.ts +0 -103
- package/tests/database/sqlite-adapter.bench.ts +0 -63
- package/tests/database/sqlite-adapter.test.ts +0 -690
- package/tests/database/tags.test.ts +0 -134
- package/tests/e2e/README.md +0 -39
- package/tests/e2e/auth.spec.ts +0 -106
- package/tests/e2e/codemode-abuse.spec.ts +0 -75
- package/tests/e2e/health.spec.ts +0 -63
- package/tests/e2e/helpers.ts +0 -139
- package/tests/e2e/oauth-discovery.spec.ts +0 -102
- package/tests/e2e/oauth-scopes.spec.ts +0 -222
- package/tests/e2e/payloads-admin.spec.ts +0 -76
- package/tests/e2e/payloads-analytics.spec.ts +0 -37
- package/tests/e2e/payloads-backup-restore.spec.ts +0 -102
- package/tests/e2e/payloads-backup.spec.ts +0 -44
- package/tests/e2e/payloads-codemode-api.spec.ts +0 -131
- package/tests/e2e/payloads-codemode-readonly.spec.ts +0 -116
- package/tests/e2e/payloads-codemode.spec.ts +0 -116
- package/tests/e2e/payloads-core.spec.ts +0 -82
- package/tests/e2e/payloads-error-contracts.spec.ts +0 -159
- package/tests/e2e/payloads-export.spec.ts +0 -46
- package/tests/e2e/payloads-github-degradation.spec.ts +0 -73
- package/tests/e2e/payloads-github.spec.ts +0 -176
- package/tests/e2e/payloads-relationships.spec.ts +0 -56
- package/tests/e2e/payloads-search.spec.ts +0 -64
- package/tests/e2e/payloads-team-happy.spec.ts +0 -231
- package/tests/e2e/payloads-team.spec.ts +0 -174
- package/tests/e2e/prompts-expanded.spec.ts +0 -137
- package/tests/e2e/prompts.spec.ts +0 -62
- package/tests/e2e/protocols.spec.ts +0 -134
- package/tests/e2e/rate-limiting.spec.ts +0 -291
- package/tests/e2e/resources-briefing-env.spec.ts +0 -106
- package/tests/e2e/resources-complete.spec.ts +0 -180
- package/tests/e2e/resources-expanded.spec.ts +0 -83
- package/tests/e2e/resources-instructions-levels.spec.ts +0 -145
- package/tests/e2e/resources-templates.spec.ts +0 -123
- package/tests/e2e/resources.spec.ts +0 -103
- package/tests/e2e/scheduler.spec.ts +0 -79
- package/tests/e2e/security.spec.ts +0 -112
- package/tests/e2e/session-advanced.spec.ts +0 -152
- package/tests/e2e/sessions.spec.ts +0 -95
- package/tests/e2e/stateless.spec.ts +0 -79
- package/tests/e2e/streaming.spec.ts +0 -176
- package/tests/e2e/tool-filtering-presets.spec.ts +0 -192
- package/tests/e2e/tool-filtering.spec.ts +0 -77
- package/tests/e2e/tools.spec.ts +0 -111
- package/tests/filtering/tool-filter.test.ts +0 -314
- package/tests/github/client-issues-errors.test.ts +0 -433
- package/tests/github/github-integration-branches.test.ts +0 -490
- package/tests/github/github-integration.test.ts +0 -1015
- package/tests/github/github-managers-branches.test.ts +0 -907
- package/tests/github/pull-requests.test.ts +0 -334
- package/tests/handlers/analytics-branches.test.ts +0 -222
- package/tests/handlers/backup-branches.test.ts +0 -270
- package/tests/handlers/briefing-context-section.test.ts +0 -388
- package/tests/handlers/briefing-github-section.test.ts +0 -392
- package/tests/handlers/briefing-user-message.test.ts +0 -405
- package/tests/handlers/codemode-tools.test.ts +0 -85
- package/tests/handlers/copilot-tools.test.ts +0 -126
- package/tests/handlers/error-path-coverage.test.ts +0 -324
- package/tests/handlers/export-tools.test.ts +0 -203
- package/tests/handlers/github-resource-handlers.test.ts +0 -929
- package/tests/handlers/github-tool-handlers.test.ts +0 -1452
- package/tests/handlers/handler-error-branches.test.ts +0 -346
- package/tests/handlers/help-resource.test.ts +0 -92
- package/tests/handlers/prompt-handler-coverage.test.ts +0 -108
- package/tests/handlers/prompt-handlers.test.ts +0 -131
- package/tests/handlers/resource-handler-coverage.test.ts +0 -281
- package/tests/handlers/resource-handlers.test.ts +0 -357
- package/tests/handlers/resource-prompt-branches.test.ts +0 -495
- package/tests/handlers/search-tool-handlers.test.ts +0 -379
- package/tests/handlers/targeted-gap-closure.test.ts +0 -387
- package/tests/handlers/team-admin.test.ts +0 -291
- package/tests/handlers/team-analytics.test.ts +0 -220
- package/tests/handlers/team-core.test.ts +0 -148
- package/tests/handlers/team-data.test.ts +0 -198
- package/tests/handlers/team-relationships.test.ts +0 -271
- package/tests/handlers/team-resource-handlers.test.ts +0 -161
- package/tests/handlers/team-search.test.ts +0 -134
- package/tests/handlers/team-tool-handlers.test.ts +0 -301
- package/tests/handlers/team-vector.test.ts +0 -213
- package/tests/handlers/template-github-branches.test.ts +0 -676
- package/tests/handlers/tool-annotations.test.ts +0 -90
- package/tests/handlers/tool-handler-coverage.test.ts +0 -514
- package/tests/handlers/tool-handlers.test.ts +0 -510
- package/tests/handlers/tool-output-schemas.test.ts +0 -116
- package/tests/handlers/vector-tool-handlers.test.ts +0 -238
- package/tests/security/sql-injection.test.ts +0 -284
- package/tests/server/mcp-server.bench.ts +0 -55
- package/tests/server/mcp-server.test.ts +0 -1326
- package/tests/server/scheduler.test.ts +0 -400
- package/tests/transports/http-legacy-sse.test.ts +0 -275
- package/tests/transports/http-security.test.ts +0 -322
- package/tests/transports/http-stateful.test.ts +0 -487
- package/tests/transports/http-transport-server.test.ts +0 -301
- package/tests/transports/http-transport.test.ts +0 -771
- package/tests/utils/github-helpers.test.ts +0 -58
- package/tests/utils/logger.test.ts +0 -180
- package/tests/utils/mcp-logger.test.ts +0 -211
- package/tests/utils/progress-utils.test.ts +0 -156
- package/tests/utils/query-helpers.test.ts +0 -80
- package/tests/utils/security-utils.test.ts +0 -82
- package/tests/vector/vector-search-branches.test.ts +0 -111
- package/tests/vector/vector-search-manager.test.ts +0 -375
- package/tests/vector/vector-search.bench.ts +0 -48
- package/tsconfig.json +0 -42
- package/tsup.config.ts +0 -19
- package/vitest.config.ts +0 -25
package/DOCKER_README.md
DELETED
|
@@ -1,331 +0,0 @@
|
|
|
1
|
-
# Memory Journal MCP Server
|
|
2
|
-
|
|
3
|
-
[](https://github.com/neverinfamous/memory-journal-mcp)
|
|
4
|
-
[](https://hub.docker.com/r/writenotenow/memory-journal-mcp)
|
|
5
|
-
[](https://opensource.org/licenses/MIT)
|
|
6
|
-

|
|
7
|
-
[](https://www.npmjs.com/package/memory-journal-mcp)
|
|
8
|
-
[](https://github.com/neverinfamous/memory-journal-mcp/blob/main/SECURITY.md)
|
|
9
|
-
[](https://github.com/neverinfamous/memory-journal-mcp)
|
|
10
|
-
[](https://github.com/neverinfamous/memory-journal-mcp)
|
|
11
|
-

|
|
12
|
-

|
|
13
|
-

|
|
14
|
-
|
|
15
|
-
🎯 **AI Context + Project Intelligence:** Bridge disconnected AI sessions with persistent project memory and **automatic session handoff** — with full GitHub workflow integration.
|
|
16
|
-
|
|
17
|
-
**[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)**
|
|
18
|
-
|
|
19
|
-
## 🎯 What This Does
|
|
20
|
-
|
|
21
|
-
### What Sets Us Apart
|
|
22
|
-
|
|
23
|
-
**61 MCP Tools** · **16 Workflow Prompts** · **28 Resources** · **10 Tool Groups** · **Code Mode** · **GitHub Integration** (Issues, PRs, Actions, Kanban, Milestones, Insights) · **Team Collaboration** (Shared DB, Vector Search, Cross-Project Insights)
|
|
24
|
-
|
|
25
|
-
| Feature | Description |
|
|
26
|
-
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
27
|
-
| **Dynamic Context Management** | AI agents automatically query your project history and create entries at the right moments |
|
|
28
|
-
| **GitHub Integration** | 16 tools covering Issues, PRs, Actions, Kanban boards, Milestones with completion %, Copilot Reviews, and 14-day repository Insights (stars, clones, views, referrers) |
|
|
29
|
-
| **Knowledge Graphs** | 8 relationship types linking specs → implementations → tests → PRs with automatic Mermaid visualization |
|
|
30
|
-
| **Triple Search** | Full-text (FTS5), semantic (AI-powered via `@huggingface/transformers` + `sqlite-vec`), and date-range search in one server |
|
|
31
|
-
| **Code Mode** | **Massive Token Savings:** Execute complex, multi-step operations inside a secure JavaScript sandbox — reducing token overhead by up to 90% while exposing all 61 capabilities via `mj.*` API |
|
|
32
|
-
| **Configurable Briefing** | 12 env vars / CLI flags to customize `memory://briefing` — control entry count, team inclusion, issue/PR/workflow detail level, Copilot review aggregation, rules/skills awareness, and workflow summary (`memory://workflows`) |
|
|
33
|
-
| **Session Continuity** | `/session-summary` captures progress and feeds it into the next session's briefing — context flows seamlessly across disconnected AI threads |
|
|
34
|
-
| **Reports & Analytics** | Generate standups, retrospectives, PR summaries, weekly digests, period analyses, and milestone tracking from your journal data |
|
|
35
|
-
| **Team Collaboration** | 20 dedicated team tools providing full functionality parity — including CRUD, isolated semantic vector search, relationship graphs, and cross-project insights via a shared database with author attribution |
|
|
36
|
-
| **Backup & Restore** | One-command backup/restore with automated scheduling, retention policies, and auto-backup-on-restore safety net |
|
|
37
|
-
| **OAuth 2.1 + Access Control** | Enterprise-ready security with RFC 9728/8414 compliance, granular scopes (`read`, `write`, `admin`), JWT/JWKS validation, and Keycloak-compatible integration |
|
|
38
|
-
| **HTTP Streaming Transport** | Dual-protocol HTTP with Streamable HTTP + Legacy SSE, security headers, rate limiting, CORS, and stateless mode for serverless |
|
|
39
|
-
| **Production-Ready Security** | SQL injection prevention, input validation, path traversal protection, token scrubbing, security headers, and non-root Docker execution |
|
|
40
|
-
| **Rule & Skill Suggestions** | Agents offer to codify recurring patterns into reusable rules and skills with your approval |
|
|
41
|
-
| **Cross-Agent Memory** | IDE agents and GitHub Copilot share context through journal entries — Copilot review findings become searchable knowledge, IDE agents proactively apply past patterns ([setup guide](https://github.com/neverinfamous/memory-journal-mcp/blob/main/docs/copilot-setup.md)) |
|
|
42
|
-
|
|
43
|
-
**[See complete examples & prompts →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Examples)**
|
|
44
|
-
|
|
45
|
-
## Rule (Add to AGENTS.md, GEMINI.md, etc)
|
|
46
|
-
|
|
47
|
-
## Session Start
|
|
48
|
-
|
|
49
|
-
**REQUIRED**: Before processing any user request, read `memory://briefing` and **present the briefing to the user as a two-column markdown table** (Context | Value). Include all available context fields. Omit rows where the data is absent. **[Full example →](https://github.com/neverinfamous/memory-journal-mcp#rule-add-to-agentsmd-geminimd-etc)**
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
53
|
-
### Tool Filtering
|
|
54
|
-
|
|
55
|
-
> [!IMPORTANT]
|
|
56
|
-
> All shortcuts and tool groups include **Code Mode** (`mj_execute_code`) by default for token-efficient operations. To exclude it, add `-codemode` to your filter: `--tool-filter starter,-codemode`
|
|
57
|
-
|
|
58
|
-
Control which tools are exposed via `MEMORY_JOURNAL_MCP_TOOL_FILTER` (or CLI: `--tool-filter`):
|
|
59
|
-
|
|
60
|
-
| Filter | Tools | Use Case |
|
|
61
|
-
| -------------------- | ----- | ------------------------ |
|
|
62
|
-
| `full` | 61 | All tools (default) |
|
|
63
|
-
| `starter` | ~11 | Core + search + codemode |
|
|
64
|
-
| `essential` | ~7 | Minimal footprint |
|
|
65
|
-
| `readonly` | ~15 | Disable all mutations |
|
|
66
|
-
| `-github` | 45 | Exclude a group |
|
|
67
|
-
| `-github,-analytics` | 43 | Exclude multiple groups |
|
|
68
|
-
|
|
69
|
-
**Filter Syntax:** `shortcut` or `group` or `tool_name` (whitelist mode) · `-group` (disable group) · `-tool` (disable tool) · `+tool` (re-enable after group disable)
|
|
70
|
-
|
|
71
|
-
**Custom Selection:** List individual tool names to create your own whitelist: `--tool-filter "create_entry,search_entries,semantic_search"`
|
|
72
|
-
|
|
73
|
-
**Groups:** `core`, `search`, `analytics`, `relationships`, `export`, `admin`, `github`, `backup`, `team`, `codemode`
|
|
74
|
-
|
|
75
|
-
**[Complete tool filtering guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tool-Filtering)**
|
|
76
|
-
|
|
77
|
-
## 📋 Core Capabilities
|
|
78
|
-
|
|
79
|
-
### 🛠️ **61 MCP Tools** (10 Groups)
|
|
80
|
-
|
|
81
|
-
| Group | Tools | Description |
|
|
82
|
-
| --------------- | ----- | ------------------------------------------------------------------------------------------------------------------- |
|
|
83
|
-
| `codemode` | 1 | Code Mode (sandboxed code execution) 🌟 **Recommended** |
|
|
84
|
-
| `core` | 6 | Entry CRUD, tags, test |
|
|
85
|
-
| `search` | 4 | Text search, date range, semantic, vector stats |
|
|
86
|
-
| `analytics` | 2 | Statistics, cross-project insights |
|
|
87
|
-
| `relationships` | 2 | Link entries, visualize graphs |
|
|
88
|
-
| `export` | 1 | JSON/Markdown export |
|
|
89
|
-
| `admin` | 5 | Update, delete, rebuild/add to vector index, merge tags |
|
|
90
|
-
| `github` | 16 | Issues, PRs, context, Kanban, **Milestones**, **Insights**, **issue lifecycle**, **Copilot Reviews** |
|
|
91
|
-
| `backup` | 4 | Backup, list, restore, cleanup |
|
|
92
|
-
| `team` | 20 | CRUD, search, stats, relationships, export, backup, vector search, cross-project insights (requires `TEAM_DB_PATH`) |
|
|
93
|
-
|
|
94
|
-
**[Complete tools reference →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Tools)**
|
|
95
|
-
|
|
96
|
-
### 🎯 **16 Workflow Prompts**
|
|
97
|
-
|
|
98
|
-
Standups, retrospectives, PR summaries, weekly digests, period analysis, milestone tracking, context bundles, session summaries, and more. **[Complete prompts guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Prompts)**
|
|
99
|
-
|
|
100
|
-
### 📡 **28 Resources** (20 Static + 8 Template)
|
|
101
|
-
|
|
102
|
-
20 static resources (`memory://briefing`, `memory://workflows`, `memory://rules`, `memory://health`, `memory://help`, `memory://help/gotchas`, GitHub status/insights, team stats, and more) plus 8 template resources for project timelines, issue/PR entries, Kanban boards, milestone details, and per-group help. **[Resources documentation →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Resources)**
|
|
103
|
-
|
|
104
|
-
## 🚀 Quick Start (2 Minutes)
|
|
105
|
-
|
|
106
|
-
**Prerequisites:** Docker installed and running · ~250MB disk space · **[Full Installation Guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Installation)**
|
|
107
|
-
|
|
108
|
-
### 1. Pull the Image
|
|
109
|
-
|
|
110
|
-
```bash
|
|
111
|
-
docker pull writenotenow/memory-journal-mcp:latest
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 2. Create Data Directory
|
|
115
|
-
|
|
116
|
-
```bash
|
|
117
|
-
mkdir data
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
### 3. Add to MCP Config
|
|
121
|
-
|
|
122
|
-
Add this to your `~/.cursor/mcp.json`, Claude Desktop config, or equivalent:
|
|
123
|
-
|
|
124
|
-
```json
|
|
125
|
-
{
|
|
126
|
-
"mcpServers": {
|
|
127
|
-
"memory-journal-mcp": {
|
|
128
|
-
"command": "docker",
|
|
129
|
-
"args": [
|
|
130
|
-
"run",
|
|
131
|
-
"--rm",
|
|
132
|
-
"-i",
|
|
133
|
-
"-v",
|
|
134
|
-
"./data:/app/data",
|
|
135
|
-
"-e",
|
|
136
|
-
"GITHUB_TOKEN",
|
|
137
|
-
"-e",
|
|
138
|
-
"GITHUB_REPO_PATH=/app/repo",
|
|
139
|
-
"-v",
|
|
140
|
-
"/path/to/your/repo:/app/repo:ro",
|
|
141
|
-
"writenotenow/memory-journal-mcp:latest"
|
|
142
|
-
],
|
|
143
|
-
"env": {
|
|
144
|
-
"GITHUB_TOKEN": "ghp_your_token_here"
|
|
145
|
-
}
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
**Variants** (modify the config above):
|
|
152
|
-
|
|
153
|
-
| Variant | Change |
|
|
154
|
-
| ----------------------- | --------------------------------------------------------------------------------------- |
|
|
155
|
-
| **Minimal (no GitHub)** | Remove the `-e GITHUB_TOKEN`, `-e GITHUB_REPO_PATH`, repo volume mount, and `env` block |
|
|
156
|
-
| **Team collaboration** | Add `-e`, `"TEAM_DB_PATH=/app/data/team.db"` to `args` |
|
|
157
|
-
| **Code Mode only** | Add `"--tool-filter"`, `"codemode"` to `args` (single tool, all capabilities) |
|
|
158
|
-
|
|
159
|
-
| **Briefing config** | Add `-e`, `"BRIEFING_ENTRY_COUNT=5"` to `args` (see env var table below) |
|
|
160
|
-
| **Local build** | Replace `writenotenow/memory-journal-mcp:latest` with your local image name |
|
|
161
|
-
|
|
162
|
-
### 4. Restart & Journal!
|
|
163
|
-
|
|
164
|
-
Restart Cursor or your MCP client and start journaling!
|
|
165
|
-
|
|
166
|
-
| Environment Variable | Description |
|
|
167
|
-
| --------------------------------- | ------------------------------------------------------------------------------------------------- |
|
|
168
|
-
| `DB_PATH` | Database location (default: `/app/data/memory_journal.db` in Docker) |
|
|
169
|
-
| `TEAM_DB_PATH` | Team database file location (CLI: `--team-db`) |
|
|
170
|
-
| `TEAM_AUTHOR` | Override author name for team entries (default: `git config user.name`) |
|
|
171
|
-
| `GITHUB_TOKEN` | GitHub personal access token for API access |
|
|
172
|
-
| `GITHUB_REPO_PATH` | Path to git repo inside container (mount your repo) |
|
|
173
|
-
| `DEFAULT_PROJECT_NUMBER` | Default GitHub Project number for auto-assignment when creating issues |
|
|
174
|
-
| `AUTO_REBUILD_INDEX` | Set to `true` to rebuild vector index on server startup |
|
|
175
|
-
| `MCP_HOST` | Server bind host (`0.0.0.0` for containers, default: `localhost`) |
|
|
176
|
-
| `MCP_AUTH_TOKEN` | Bearer token for HTTP transport authentication (CLI: `--auth-token`) |
|
|
177
|
-
| `MCP_ENABLE_HSTS` | Enable HSTS security header on HTTP responses (CLI: `--enable-hsts`; default: `false`) |
|
|
178
|
-
| `OAUTH_ENABLED` | Set to `true` to enable OAuth 2.1 authentication (HTTP only) |
|
|
179
|
-
| `OAUTH_ISSUER` | OAuth issuer URL (e.g., `https://auth.example.com/realms/mcp`) |
|
|
180
|
-
| `OAUTH_AUDIENCE` | Expected JWT audience claim |
|
|
181
|
-
| `OAUTH_JWKS_URI` | JWKS endpoint for token signature verification |
|
|
182
|
-
| `BRIEFING_ENTRY_COUNT` | Journal entries in briefing (CLI: `--briefing-entries`; default: `3`) |
|
|
183
|
-
| `BRIEFING_INCLUDE_TEAM` | Include team DB entries in briefing (`true`/`false`; default: `false`) |
|
|
184
|
-
| `BRIEFING_ISSUE_COUNT` | Issues to list in briefing; `0` = count only (default: `0`) |
|
|
185
|
-
| `BRIEFING_PR_COUNT` | PRs to list in briefing; `0` = count only (default: `0`) |
|
|
186
|
-
| `BRIEFING_PR_STATUS` | Show PR status breakdown (open/merged/closed; default: `false`) |
|
|
187
|
-
| `BRIEFING_WORKFLOW_COUNT` | Workflow runs to list in briefing; `0` = status only (default: `0`) |
|
|
188
|
-
| `BRIEFING_WORKFLOW_STATUS` | Show workflow status breakdown in briefing (default: `false`) |
|
|
189
|
-
| `BRIEFING_COPILOT_REVIEWS` | Aggregate Copilot review state in briefing (default: `false`) |
|
|
190
|
-
| `RULES_FILE_PATH` | Path to user rules file for agent awareness (CLI: `--rules-file`) |
|
|
191
|
-
| `SKILLS_DIR_PATH` | Path to skills directory for agent awareness (CLI: `--skills-dir`) |
|
|
192
|
-
| `MEMORY_JOURNAL_WORKFLOW_SUMMARY` | Free-text workflow summary for `memory://workflows` (CLI: `--workflow-summary`) |
|
|
193
|
-
| `INSTRUCTION_LEVEL` | Briefing depth: `essential`, `standard`, `full` (CLI: `--instruction-level`; default: `standard`) |
|
|
194
|
-
|
|
195
|
-
**Without `GITHUB_REPO_PATH`**: Explicitly provide `owner` and `repo` when calling GitHub tools.
|
|
196
|
-
|
|
197
|
-
**Fallback:** With `GITHUB_REPO_PATH` set, tools auto-detect `owner`/`repo` from git config. Without it, provide `owner` and `repo` args explicitly. Mount read-only: `-v /path/to/repo:/app/repo:ro`.
|
|
198
|
-
|
|
199
|
-
### 🔄 Session Management
|
|
200
|
-
|
|
201
|
-
1. **Session start** → agent reads `memory://briefing` and shows project context
|
|
202
|
-
2. **Session summary** → use `/session-summary` to capture progress and next-session context
|
|
203
|
-
3. Next session's briefing includes the previous summary — context flows seamlessly
|
|
204
|
-
|
|
205
|
-
### HTTP/SSE Transport (Remote Access)
|
|
206
|
-
|
|
207
|
-
For remote access, web-based clients, or HTTP-compatible MCP hosts:
|
|
208
|
-
|
|
209
|
-
**Stateful Mode (default):**
|
|
210
|
-
|
|
211
|
-
```bash
|
|
212
|
-
docker run --rm -p 3000:3000 \
|
|
213
|
-
-v ./data:/app/data \
|
|
214
|
-
writenotenow/memory-journal-mcp:latest \
|
|
215
|
-
--transport http --port 3000 --server-host 0.0.0.0
|
|
216
|
-
```
|
|
217
|
-
|
|
218
|
-
**Stateless Mode (serverless):**
|
|
219
|
-
|
|
220
|
-
```bash
|
|
221
|
-
docker run --rm -p 3000:3000 \
|
|
222
|
-
-v ./data:/app/data \
|
|
223
|
-
writenotenow/memory-journal-mcp:latest \
|
|
224
|
-
--transport http --port 3000 --server-host 0.0.0.0 --stateless
|
|
225
|
-
```
|
|
226
|
-
|
|
227
|
-
**Endpoints:**
|
|
228
|
-
|
|
229
|
-
| Endpoint | Description | Mode |
|
|
230
|
-
| ------------------------------------------- | ------------------------------------------------ | -------- |
|
|
231
|
-
| `GET /` | Server info and available endpoints | Both |
|
|
232
|
-
| `POST /mcp` | JSON-RPC requests (initialize, tools/call, etc.) | Both |
|
|
233
|
-
| `GET /mcp` | SSE stream for server-to-client notifications | Stateful |
|
|
234
|
-
| `DELETE /mcp` | Session termination | Stateful |
|
|
235
|
-
| `GET /sse` | Legacy SSE connection (MCP 2024-11-05) | Stateful |
|
|
236
|
-
| `POST /messages` | Legacy SSE message endpoint | Stateful |
|
|
237
|
-
| `GET /health` | Health check (`{ status, timestamp }`) | Both |
|
|
238
|
-
| `GET /.well-known/oauth-protected-resource` | RFC 9728 Protected Resource Metadata | Both |
|
|
239
|
-
|
|
240
|
-
**Session Management:** In stateful mode, include the `mcp-session-id` header (returned from initialization) in subsequent requests.
|
|
241
|
-
|
|
242
|
-
- **OAuth 2.1** — RFC 9728/8414, JWT/JWKS, granular scopes (opt-in via `--oauth-enabled`)
|
|
243
|
-
- **7 Security Headers** — CSP, HSTS (opt-in), X-Frame-Options, and more
|
|
244
|
-
- **Rate Limiting** — 100 req/min per IP · **CORS** — configurable multi-origin (exact-match) · **1MB body limit**
|
|
245
|
-
- **Server Timeouts** — Request (120s), keep-alive (65s), headers (66s) · **404 handler** · **Cross-protocol guard**
|
|
246
|
-
- **Build Provenance** · **SBOM** · **Supply Chain Attestations** · **Non-root execution**
|
|
247
|
-
|
|
248
|
-
| Mode | Progress Notifications | Legacy SSE | Serverless |
|
|
249
|
-
| ------------------------- | ---------------------- | ---------- | ---------- |
|
|
250
|
-
| Stateful (default) | ✅ Yes | ✅ Yes | ⚠️ Complex |
|
|
251
|
-
| Stateless (`--stateless`) | ❌ No | ❌ No | ✅ Native |
|
|
252
|
-
|
|
253
|
-
#### Automated Scheduling (HTTP Only)
|
|
254
|
-
|
|
255
|
-
Enable periodic maintenance jobs for long-running containers. These jobs run in-process on `setInterval` — no external cron needed.
|
|
256
|
-
|
|
257
|
-
> **Note:** These flags only work with HTTP/SSE transport. Stdio sessions (IDE integrations) are short-lived — use `backup_journal` and `cleanup_backups` tools manually instead.
|
|
258
|
-
|
|
259
|
-
```bash
|
|
260
|
-
docker run --rm -p 3000:3000 \
|
|
261
|
-
-v ./data:/app/data \
|
|
262
|
-
writenotenow/memory-journal-mcp:latest \
|
|
263
|
-
--transport http --port 3000 --server-host 0.0.0.0 \
|
|
264
|
-
--backup-interval 60 --keep-backups 10 \
|
|
265
|
-
--vacuum-interval 1440 \
|
|
266
|
-
--rebuild-index-interval 720
|
|
267
|
-
```
|
|
268
|
-
|
|
269
|
-
| Flag | Default | Description |
|
|
270
|
-
| -------------------------------- | ------- | -------------------------------------------------------------------- |
|
|
271
|
-
| `--backup-interval <min>` | 0 (off) | Create timestamped database backups and prune old ones automatically |
|
|
272
|
-
| `--keep-backups <count>` | 5 | Max backups retained during automated cleanup |
|
|
273
|
-
| `--vacuum-interval <min>` | 0 (off) | Run `PRAGMA optimize` and flush database to disk |
|
|
274
|
-
| `--rebuild-index-interval <min>` | 0 (off) | Full vector index rebuild to maintain semantic search quality |
|
|
275
|
-
|
|
276
|
-
Each job is error-isolated — a failure in one job won't affect the others. Scheduler status (last run, result, next run) is visible via `memory://health`.
|
|
277
|
-
|
|
278
|
-
## 🔐 OAuth 2.1 Authentication
|
|
279
|
-
|
|
280
|
-
For production deployments, enable OAuth 2.1 on the HTTP transport:
|
|
281
|
-
|
|
282
|
-
| Component | Status | Description |
|
|
283
|
-
| --------------------------- | ------ | ------------------------------------------------ |
|
|
284
|
-
| Protected Resource Metadata | ✅ | RFC 9728 `/.well-known/oauth-protected-resource` |
|
|
285
|
-
| Auth Server Discovery | ✅ | RFC 8414 metadata discovery with caching |
|
|
286
|
-
| Token Validation | ✅ | JWT validation with JWKS support |
|
|
287
|
-
| Scope Enforcement | ✅ | Granular `read`, `write`, `admin` scopes |
|
|
288
|
-
| HTTP Transport | ✅ | Streamable HTTP with OAuth middleware |
|
|
289
|
-
|
|
290
|
-
**Scopes:** `read` (core, search, analytics, relationships, export) · `write` (github, team + read) · `admin` (admin, backup, codemode + all)
|
|
291
|
-
|
|
292
|
-
```bash
|
|
293
|
-
docker run --rm -p 3000:3000 \
|
|
294
|
-
-v ./data:/app/data \
|
|
295
|
-
-e OAUTH_ENABLED=true \
|
|
296
|
-
-e OAUTH_ISSUER=https://auth.example.com/realms/mcp \
|
|
297
|
-
-e OAUTH_AUDIENCE=memory-journal-mcp \
|
|
298
|
-
writenotenow/memory-journal-mcp:latest \
|
|
299
|
-
--transport http --port 3000 --server-host 0.0.0.0
|
|
300
|
-
```
|
|
301
|
-
|
|
302
|
-
> **Note:** OAuth is opt-in. When not enabled, the server falls back to simple token authentication via `MCP_AUTH_TOKEN`, or runs without authentication.
|
|
303
|
-
|
|
304
|
-
## 🔧 Configuration
|
|
305
|
-
|
|
306
|
-
### GitHub Management Capabilities
|
|
307
|
-
|
|
308
|
-
16 GitHub tools covering issues, PRs, Kanban boards, milestones (with completion %), repository insights, Copilot reviews, and issue lifecycle with journal linking. Standard mutations (create/close issues, merge PRs) are handled by agents via `gh` CLI. **[Complete GitHub integration guide →](https://github.com/neverinfamous/memory-journal-mcp/wiki/Git-Integration)**
|
|
309
|
-
|
|
310
|
-
## 🏗️ Build from Source
|
|
311
|
-
|
|
312
|
-
```bash
|
|
313
|
-
git clone https://github.com/neverinfamous/memory-journal-mcp.git
|
|
314
|
-
cd memory-journal-mcp
|
|
315
|
-
docker build -f Dockerfile -t memory-journal-mcp-local .
|
|
316
|
-
```
|
|
317
|
-
|
|
318
|
-
Then use `memory-journal-mcp-local` as the image name in your MCP config (see Quick Start above).
|
|
319
|
-
|
|
320
|
-
## 📚 Documentation & Resources
|
|
321
|
-
|
|
322
|
-
- **[GitHub Wiki](https://github.com/neverinfamous/memory-journal-mcp/wiki)** - Complete documentation
|
|
323
|
-
- **[Copilot Setup Guide](https://github.com/neverinfamous/memory-journal-mcp/blob/main/docs/copilot-setup.md)** - Cross-agent memory bridge between IDE agents and GitHub Copilot
|
|
324
|
-
- **[npm Package](https://www.npmjs.com/package/memory-journal-mcp)** - Node.js distribution
|
|
325
|
-
- **[Issues](https://github.com/neverinfamous/memory-journal-mcp/issues)** - Bug reports & feature requests
|
|
326
|
-
|
|
327
|
-
## 📄 License
|
|
328
|
-
|
|
329
|
-
MIT License - See [LICENSE](https://github.com/neverinfamous/memory-journal-mcp/blob/main/LICENSE)
|
|
330
|
-
|
|
331
|
-
_Migrating from v2.x?_ Your existing database is fully compatible.
|
package/Dockerfile
DELETED
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
# Memory Journal MCP Server - TypeScript Version
|
|
2
|
-
# Multi-stage build for optimized production image
|
|
3
|
-
FROM node:24-alpine AS builder
|
|
4
|
-
|
|
5
|
-
WORKDIR /app
|
|
6
|
-
|
|
7
|
-
# Install build dependencies and upgrade packages for security
|
|
8
|
-
# Use Alpine edge for latest security patches (curl CVE-2025-14524, zlib CVE-2026-27171, etc.)
|
|
9
|
-
RUN apk add --no-cache python3 make g++ && \
|
|
10
|
-
apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/main curl zlib && \
|
|
11
|
-
apk upgrade --no-cache
|
|
12
|
-
|
|
13
|
-
# Upgrade npm globally to get fixed versions of bundled packages
|
|
14
|
-
# Fixes CVE-2025-64756 (glob), CVE-2025-64118 (tar)
|
|
15
|
-
RUN npm install -g npm@latest --force && npm cache clean --force
|
|
16
|
-
|
|
17
|
-
# Fix GHSA-73rr-hh4g-fpgx: Manually update npm's bundled diff@8.0.2 to 8.0.3
|
|
18
|
-
# npm hasn't released a version with diff@8.0.3 yet, so we patch it directly
|
|
19
|
-
RUN cd /usr/local/lib/node_modules/npm && \
|
|
20
|
-
npm pack diff@8.0.3 && \
|
|
21
|
-
rm -rf node_modules/diff && \
|
|
22
|
-
tar -xzf diff-8.0.3.tgz && \
|
|
23
|
-
mv package node_modules/diff && \
|
|
24
|
-
rm diff-8.0.3.tgz
|
|
25
|
-
|
|
26
|
-
# Fix CVE-2026-23950, CVE-2026-24842, CVE-2026-26960, GHSA-qffp-2rhf-9h96: Manually update npm's bundled tar to 7.5.11
|
|
27
|
-
RUN cd /usr/local/lib/node_modules/npm && \
|
|
28
|
-
npm pack tar@7.5.11 && \
|
|
29
|
-
rm -rf node_modules/tar && \
|
|
30
|
-
tar -xzf tar-7.5.11.tgz && \
|
|
31
|
-
mv package node_modules/tar && \
|
|
32
|
-
rm tar-7.5.11.tgz
|
|
33
|
-
|
|
34
|
-
# Fix CVE-2026-27903, CVE-2026-27904: Manually update npm's bundled minimatch to 10.2.4
|
|
35
|
-
RUN cd /usr/local/lib/node_modules/npm && \
|
|
36
|
-
npm pack minimatch@10.2.4 && \
|
|
37
|
-
rm -rf node_modules/minimatch && \
|
|
38
|
-
tar -xzf minimatch-10.2.4.tgz && \
|
|
39
|
-
mv package node_modules/minimatch && \
|
|
40
|
-
rm minimatch-10.2.4.tgz
|
|
41
|
-
|
|
42
|
-
# Copy package files first for better layer caching
|
|
43
|
-
COPY package*.json .npmrc ./
|
|
44
|
-
|
|
45
|
-
# Install all dependencies (including devDependencies for build)
|
|
46
|
-
# The .npmrc has legacy-peer-deps=true to handle zod peer conflicts
|
|
47
|
-
RUN npm ci
|
|
48
|
-
|
|
49
|
-
# Remove protobufjs CLI entirely - not needed at runtime
|
|
50
|
-
# Eliminates CVE-2019-10790 (taffydb), CVE-2025-54798 (tmp), CVE-2025-5889 (brace-expansion)
|
|
51
|
-
RUN rm -rf node_modules/protobufjs/cli
|
|
52
|
-
|
|
53
|
-
# Copy source code
|
|
54
|
-
COPY tsconfig.json tsup.config.ts ./
|
|
55
|
-
COPY src/ ./src/
|
|
56
|
-
|
|
57
|
-
# Build TypeScript
|
|
58
|
-
RUN npm run build
|
|
59
|
-
|
|
60
|
-
# Install production-only dependencies in a separate directory for clean copy
|
|
61
|
-
RUN mkdir /app/prod_modules && \
|
|
62
|
-
cp package*.json .npmrc /app/prod_modules/ && \
|
|
63
|
-
cd /app/prod_modules && \
|
|
64
|
-
npm ci --omit=dev && \
|
|
65
|
-
rm -rf node_modules/protobufjs/cli && \
|
|
66
|
-
npm cache clean --force
|
|
67
|
-
|
|
68
|
-
# Strip unnecessary ONNX runtime binaries from production dependencies:
|
|
69
|
-
# - Remove onnxruntime-web entirely (browser-only, not needed in Node.js)
|
|
70
|
-
# - Remove non-Linux platform binaries from onnxruntime-node (darwin, win32)
|
|
71
|
-
RUN rm -rf /app/prod_modules/node_modules/onnxruntime-web \
|
|
72
|
-
/app/prod_modules/node_modules/.onnxruntime-node-* \
|
|
73
|
-
/app/prod_modules/node_modules/onnxruntime-node/bin/napi-v3/darwin \
|
|
74
|
-
/app/prod_modules/node_modules/onnxruntime-node/bin/napi-v3/win32
|
|
75
|
-
|
|
76
|
-
# Production stage
|
|
77
|
-
FROM node:24-alpine
|
|
78
|
-
|
|
79
|
-
WORKDIR /app
|
|
80
|
-
|
|
81
|
-
# Install runtime dependencies with security fixes
|
|
82
|
-
# Use Alpine edge for curl with CVE fixes
|
|
83
|
-
# Explicit libexpat upgrade for CVE-2026-24515 (CRITICAL) and CVE-2026-25210 (MEDIUM)
|
|
84
|
-
# Explicit zlib upgrade for CVE-2026-27171 (MEDIUM)
|
|
85
|
-
RUN apk add --no-cache git ca-certificates && \
|
|
86
|
-
apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/main curl libexpat zlib && \
|
|
87
|
-
apk upgrade --no-cache && \
|
|
88
|
-
rm -rf /usr/local/lib/node_modules/npm /usr/local/bin/npm /usr/local/bin/npx
|
|
89
|
-
|
|
90
|
-
# Copy built artifacts and production dependencies from builder
|
|
91
|
-
COPY --from=builder /app/dist ./dist
|
|
92
|
-
COPY --from=builder /app/prod_modules/node_modules ./node_modules
|
|
93
|
-
COPY package*.json ./
|
|
94
|
-
COPY LICENSE ./
|
|
95
|
-
|
|
96
|
-
# Create data directory for SQLite database with proper permissions
|
|
97
|
-
RUN mkdir -p /app/data && chmod 700 /app/data
|
|
98
|
-
|
|
99
|
-
# Create non-root user for security
|
|
100
|
-
RUN addgroup -g 1001 -S appgroup && \
|
|
101
|
-
adduser -u 1001 -S appuser -G appgroup && \
|
|
102
|
-
chown -R appuser:appgroup /app
|
|
103
|
-
|
|
104
|
-
# Set environment variables
|
|
105
|
-
ENV NODE_ENV=production
|
|
106
|
-
ENV DB_PATH=/app/data/memory_journal.db
|
|
107
|
-
|
|
108
|
-
# Switch to non-root user
|
|
109
|
-
USER appuser
|
|
110
|
-
|
|
111
|
-
# Health check — validates Node.js runtime is responsive (sufficient for stdio mode,
|
|
112
|
-
# which is the default transport). For HTTP mode, override in docker-compose.yml with:
|
|
113
|
-
# healthcheck:
|
|
114
|
-
# test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
|
|
115
|
-
# interval: 30s
|
|
116
|
-
# timeout: 10s
|
|
117
|
-
# retries: 3
|
|
118
|
-
HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
|
|
119
|
-
CMD node -e "process.exit(0)" || exit 1
|
|
120
|
-
|
|
121
|
-
# Run the MCP server
|
|
122
|
-
ENTRYPOINT ["node", "dist/cli.js"]
|
|
123
|
-
|
|
124
|
-
# Labels for Docker Hub
|
|
125
|
-
LABEL maintainer="Adamic.tech"
|
|
126
|
-
LABEL description="Memory Journal MCP Server - Project context management for AI-assisted development"
|
|
127
|
-
LABEL org.opencontainers.image.source="https://github.com/neverinfamous/memory-journal-mcp"
|
|
128
|
-
LABEL io.modelcontextprotocol.server.name="io.github.neverinfamous/memory-journal-mcp"
|