callgraph-mcp 1.5.3 → 1.5.5
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 +39 -28
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -31,7 +31,7 @@ Most AI coding tools answer structural questions about your codebase by reading
|
|
|
31
31
|
|
|
32
32
|
## Setup
|
|
33
33
|
|
|
34
|
-
### Option 1 — VS Code via `npx`
|
|
34
|
+
### Option 1 — VS Code via `npx`
|
|
35
35
|
|
|
36
36
|
Add to your project's `.vscode/mcp.json`:
|
|
37
37
|
|
|
@@ -50,11 +50,30 @@ Add to your project's `.vscode/mcp.json`:
|
|
|
50
50
|
}
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
+
### Option 2
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"servers": {
|
|
58
|
+
"flowmap": {
|
|
59
|
+
"type": "stdio",
|
|
60
|
+
"command": "callgraph-mcp",
|
|
61
|
+
"args": [],
|
|
62
|
+
"env": {
|
|
63
|
+
"FLOWMAP_TRANSPORT": "stdio"
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
|
|
53
72
|
Start the server in your editor. WASM grammars are bundled — no environment variables needed.
|
|
54
73
|
|
|
55
74
|
> **Tip:** Create `.vscode/mcp.json` via the Command Palette -> **MCP: Add Server** -> **stdio**.
|
|
56
75
|
|
|
57
|
-
### Option
|
|
76
|
+
### Option 3 — HTTP-SSE (shared or remote server)
|
|
58
77
|
|
|
59
78
|
Use `FLOWMAP_TRANSPORT=http` for HTTP-SSE compatible clients.
|
|
60
79
|
|
|
@@ -83,21 +102,17 @@ Then point your client at it:
|
|
|
83
102
|
|
|
84
103
|
Optional parameters shown in `[brackets]`.
|
|
85
104
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
<tr><td><code>flowmap_find_cycles</code></td><td><code>workspacePath</code>, [<code>minCycleLength</code>], [<code>exclude</code>]</td><td>All circular call chains with exact edges</td></tr>
|
|
98
|
-
<tr><td><code>flowmap_find_duplicates</code> <em>(experimental)</em></td><td><code>workspacePath</code>, [<code>similarityThreshold</code>=0.75], [<code>minCallees</code>=2], [<code>exclude</code>]</td><td>Function clusters with similar callee sets</td></tr>
|
|
99
|
-
</tbody>
|
|
100
|
-
</table>
|
|
105
|
+
| Tool | Parameters | Returns |
|
|
106
|
+
|------|------------|---------|
|
|
107
|
+
| `flowmap_analyze_workspace` | `workspacePath`, [`exclude`], [`language`] | Full call graph: nodes, edges, flows, orphans |
|
|
108
|
+
| `flowmap_analyze_file` | `filePath` | Functions and call sites in one file |
|
|
109
|
+
| `flowmap_get_callers` | `functionName`, `workspacePath` | Direct callers of the function |
|
|
110
|
+
| `flowmap_get_callees` | `functionName`, `workspacePath` | Functions the named function calls |
|
|
111
|
+
| `flowmap_get_flow` | `functionName`, `workspacePath`, [`maxDepth`=10] | Full BFS subgraph reachable from a function |
|
|
112
|
+
| `flowmap_list_entry_points` | `workspacePath` | Mains, route handlers, CLI commands, React roots |
|
|
113
|
+
| `flowmap_find_orphans` | `workspacePath` | Functions unreachable from any entry point |
|
|
114
|
+
| `flowmap_find_cycles` | `workspacePath`, [`minCycleLength`], [`exclude`] | All circular call chains with exact edges |
|
|
115
|
+
| `flowmap_find_duplicates` *(experimental)* | `workspacePath`, [`similarityThreshold`=0.75], [`minCallees`=2], [`exclude`] | Function clusters with similar callee sets |
|
|
101
116
|
|
|
102
117
|
**`workspacePath`** — absolute path to the repo root (e.g. `/home/user/my-project` or `C:\projects\my-app`).
|
|
103
118
|
|
|
@@ -105,17 +120,13 @@ Optional parameters shown in `[brackets]`.
|
|
|
105
120
|
|
|
106
121
|
## Environment Variable Reference
|
|
107
122
|
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
<tr><td><code>FLOWMAP_DUP_THRESHOLD</code></td><td><code>0.75</code></td><td>Jaccard similarity threshold for <code>find_duplicates</code> (0–1)</td></tr>
|
|
116
|
-
<tr><td><code>FLOWMAP_DUP_MIN_CALLEES</code></td><td><code>2</code></td><td>Min callee count for <code>find_duplicates</code></td></tr>
|
|
117
|
-
</tbody>
|
|
118
|
-
</table>
|
|
123
|
+
| Variable | Default | Description |
|
|
124
|
+
|----------|---------|-------------|
|
|
125
|
+
| `FLOWMAP_TRANSPORT` | `stdio` | `stdio` or `http` |
|
|
126
|
+
| `FLOWMAP_PORT` | `3100` | HTTP port (http transport only) |
|
|
127
|
+
| `FLOWMAP_GRAMMARS` | *(bundled)* | Override path to WASM grammar files |
|
|
128
|
+
| `FLOWMAP_DUP_THRESHOLD` | `0.75` | Jaccard similarity threshold for `find_duplicates` (0–1) |
|
|
129
|
+
| `FLOWMAP_DUP_MIN_CALLEES` | `2` | Min callee count for `find_duplicates` |
|
|
119
130
|
|
|
120
131
|
---
|
|
121
132
|
|