Skip to content

Commit bf1f5ff

Browse files
committed
docs: add MCP server configuration to README
Authored-By: Aneki (joshuaboys)
1 parent 6a87232 commit bf1f5ff

File tree

1 file changed

+32
-3
lines changed

1 file changed

+32
-3
lines changed

README.md

Lines changed: 32 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ All commands support `--json` for programmatic use. Function names use fuzzy mat
101101
packages/
102102
distil-core # Analysis engine (tree-sitter parsers, L1-L5 extractors)
103103
distil-cli # Command-line interface (Commander.js)
104-
distil-mcp # MCP server for editor/agent integration (in progress)
104+
distil-mcp # MCP server for editor/agent integration
105105
```
106106

107107
```
@@ -118,13 +118,42 @@ packages/
118118

119119
## MCP Server
120120

121-
An MCP server (`@distil/mcp`) is in development for v0.1, exposing all analysis layers via the Model Context Protocol. This enables editors and agents (Claude Code, Cursor, etc.) to query Distil analysis directly.
121+
Distil includes an MCP server for editor and agent integration. Start it with:
122+
123+
```bash
124+
distil mcp
125+
```
126+
127+
Or add to your editor's MCP settings:
128+
129+
```json
130+
{
131+
"mcpServers": {
132+
"distil": {
133+
"command": "distil",
134+
"args": ["mcp"]
135+
}
136+
}
137+
}
138+
```
139+
140+
**Available MCP tools:**
141+
142+
| Tool | Description |
143+
| ---------------- | ----------------------------------------------- |
144+
| `distil_extract` | L1: Extract file structure (functions, classes) |
145+
| `distil_calls` | L2: Build project call graph |
146+
| `distil_impact` | L2: Find all callers of a function |
147+
| `distil_cfg` | L3: Control flow graph with complexity metrics |
148+
| `distil_dfg` | L4: Data flow graph with def-use chains |
149+
| `distil_slice` | L5: Program slice (backward/forward) |
150+
151+
**Workflow prompts:** `distil_before_editing`, `distil_debug_line`, `distil_refactor_impact`
122152

123153
## Roadmap
124154

125155
Planned features:
126156

127-
- **MCP server** -- expose analysis via Model Context Protocol (in progress, v0.1)
128157
- **Semantic search** -- natural language code search via embeddings
129158
- **Index warming** -- pre-build all analysis layers for fast queries
130159
- **Monorepo support** -- per-package analysis with cross-package call graphs

0 commit comments

Comments
 (0)