Skip to content

Commit f957dff

Browse files
authored
Merge pull request DeusData#712 from DeusData/docs/runtime-network-behavior
docs(security): document runtime update check
2 parents 63e3f2c + 74b1a47 commit f957dff

1 file changed

Lines changed: 25 additions & 0 deletions

File tree

‎SECURITY.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,31 @@ codebase-memory-mcp interacts deeply with your filesystem. It reads source files
88

99
We are humans and can make mistakes. We take security seriously — it is Priority #1 for this project — but we cannot guarantee perfection. By using this software you accept responsibility for evaluating whether it meets your own security requirements.
1010

11+
## Runtime Network Behavior
12+
13+
Indexing, graph queries, semantic search, and MCP tool handling run locally. The
14+
MCP server does not upload source code, repository paths, graph indexes, query
15+
contents, environment variables, usage metrics, or telemetry.
16+
17+
The MCP server has one best-effort external runtime check: after MCP
18+
`initialize`, it starts a background update-check thread that requests release
19+
metadata from
20+
`https://api.github.com/repos/DeusData/codebase-memory-mcp/releases/latest`.
21+
That request is used only to show an update notice when a newer release exists.
22+
It sends no project data; only standard HTTPS metadata, such as the destination
23+
host and the normal `curl` request headers, are visible to GitHub and the
24+
network path.
25+
26+
The update check is non-blocking for MCP startup and tool calls. If the machine
27+
is offline, DNS fails, GitHub is unreachable, or `curl` exits with an error, the
28+
check is ignored. The request is also bounded with `curl --max-time 5`; a
29+
process shutting down immediately while the check is still running may wait for
30+
that bounded background thread to finish.
31+
32+
Explicit install, package-manager, and `codebase-memory-mcp update` flows are
33+
separate user-initiated network operations that download release assets and
34+
checksums from GitHub.
35+
1136
## Help Us Stay Secure
1237

1338
**We actively invite security researchers to try to break this project.**

0 commit comments

Comments
 (0)