| Version | Supported |
|---|---|
| latest | Yes |
If you discover a security vulnerability, please report it responsibly.
Do not open a public issue.
Preferred channel: open a private advisory on GitHub:
This routes the report to the maintainers without making it public. See the GitHub guide on private vulnerability reporting for the full workflow.
If GitHub access is not available, fall back to emailing the maintainer listed on the project owner profile.
- Description of the vulnerability
- Steps to reproduce
- Potential impact
- Suggested fix (if any)
- Acknowledgment: within 48 hours
- Assessment: within 1 week
- Fix: depends on severity, typically within 2 weeks for critical issues
Reference docs:
- Never commit API keys (Jina AI, Ollama) to the repository
- Use environment variables or
.envfiles (gitignored by default) - The
.env.examplefile contains only placeholder values
- The server uses a PathGuard that restricts file access to explicitly allowlisted paths
- Path traversal attacks are prevented by resolving and validating all paths
- Repository file tools apply
MCP_ALLOW_DIRSrelative toMCP_ROOT. document_contextapplies the same relative allowlist to the configured index root. In project scope this is the main checkout, which owns the shared worktree index. The tool returns indexed content. See document context paths and freshness.
MCP_HTTP_MODE=httpenables the HTTP MCP endpointMCP_HTTP_HOSTdefaults to127.0.0.1, so a quick local HTTP run stays loopback-only by default- every route answers 403 when
Origindoes not name theHost; a loopback bind without a token also answers 403 to a non-loopbackHost, which is what stops DNS rebinding - for shared deployments set
MCP_HTTP_HOST=0.0.0.0andMCP_HTTP_AUTH_TOKEN; requests to/mcpmust then sendAuthorization: Bearer <token> - the server refuses to start on a non-loopback host without
MCP_HTTP_AUTH_TOKEN, unless you explicitly setMCP_HTTP_INSECURE_ALLOW_UNAUTHENTICATED=true - The server intentionally listens on plain HTTP; terminate TLS at a reverse proxy or load balancer
/healthis intended for health checks and does not carry MCP trafficMCP_HTTP_INSECURE_ALLOW_UNAUTHENTICATED=trueis an explicit unsafe override and should only be used for tightly controlled environmentsdeploy/nginx/agent-memory-mcp.confis the reference reverse proxy recipe for TLS termination and forwardingAuthorization/consoleserves a static retrieval inspection page; live data requests from the page go through/console/api/queryand use the same Bearer token model as/mcp
- Memory and vector index data are stored in local SQLite databases
- No data is sent to external services except embedding API calls (Jina AI, OpenAI-compatible APIs, or Ollama)
- Embedding API calls contain only document text chunks, no metadata or credentials
- RAG indexing only scans Markdown files from
MCP_INDEX_DIRS - Built-in directory excludes skip common non-source or generated folders such as
.git,.agent-memory,node_modules,logs, and.terraform MCP_INDEX_EXCLUDE_DIRSadds repo-relative path excludesMCP_INDEX_EXCLUDE_GLOBSadds glob-style path excludes such asdocs/internal/*.mdMCP_REDACT_SECRETS=trueredacts common secret-like assignments and private key blocks before content is written to the RAG index or sent to embedding providers
- Set
MCP_EMBEDDING_MODE=local-onlyto disable hosted embedding providers - In local-only mode, the server will not call Jina AI or OpenAI-compatible embedding APIs even if their keys are present
- Embedding traffic is limited to the configured local Ollama endpoint (default:
http://localhost:11434) - If Ollama is unavailable, embedding requests fail with a local-only specific error instead of silently falling back to hosted providers
- The server tracks which embedding model was used for each stored memory
- Semantic recall does not mix memories from different embedding spaces, even if vector dimensions match
- Memories from older models remain available through text matching and filters until you run
agent-memory-mcp reembed - RAG indexes are tied to the embedding model they were built with; switching models requires
agent-memory-mcp index