Skip to content

Commit b2e9240

Browse files
committed
Move stdio to secondary in docs/cli.md, HTTP as recommended
Stdio is for debugging/single-project; HTTP is the primary transport with full feature set (multi-project, UI, REST API, WebSocket).
1 parent 319a27a commit b2e9240

1 file changed

Lines changed: 14 additions & 33 deletions

File tree

docs/cli.md

Lines changed: 14 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -121,40 +121,9 @@ Each graph JSON file stores the embedding model fingerprint (model + pooling + n
121121

122122
## MCP client configuration
123123

124-
### stdio transport (single project)
124+
### HTTP transport (recommended)
125125

126-
After `npm install -g @prih/mcp-graph-memory`:
127-
128-
**Claude Desktop** — in `claude_desktop_config.json`:
129-
130-
```json
131-
{
132-
"mcpServers": {
133-
"project-memory": {
134-
"command": "mcp-graph-memory",
135-
"args": ["mcp", "--config", "/path/to/graph-memory.yaml", "--project", "my-app"]
136-
}
137-
}
138-
}
139-
```
140-
141-
**Claude Code** — in `.mcp.json` at project root:
142-
143-
```json
144-
{
145-
"mcpServers": {
146-
"project-memory": {
147-
"type": "stdio",
148-
"command": "mcp-graph-memory",
149-
"args": ["mcp", "--config", "/path/to/graph-memory.yaml", "--project", "my-app"]
150-
}
151-
}
152-
}
153-
```
154-
155-
### HTTP transport (multi-project)
156-
157-
Start the server, then connect MCP clients to `http://localhost:3000/mcp/{projectId}`.
126+
The primary connection method. Start the server with `serve`, then connect MCP clients to `http://localhost:3000/mcp/{projectId}`.
158127

159128
**Claude Desktop** — add via **Settings > Connectors** in the app, enter the URL:
160129

@@ -183,6 +152,18 @@ http://localhost:3000/mcp/my-app
183152

184153
Multiple clients can connect to the same server simultaneously. Each session gets its own MCP instance but shares graph data.
185154

155+
### stdio transport (debugging / single project)
156+
157+
The `mcp` command runs a single-project MCP server over stdin/stdout. Primarily useful for debugging or testing a single project without starting the full HTTP server.
158+
159+
```bash
160+
mcp-graph-memory mcp --config graph-memory.yaml --project my-app
161+
```
162+
163+
The MCP client launches this as a subprocess. No web UI, no REST API, no WebSocket — just the MCP tool interface over stdio.
164+
165+
For most use cases, prefer the HTTP transport above — it provides the full feature set (multi-project, web UI, REST API, real-time updates) and supports multiple concurrent clients.
166+
186167
## Development commands
187168

188169
```bash

0 commit comments

Comments
 (0)