@alucify/mcp 0.6.0
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 +44 -0
- package/dist/mcp-server.js +55 -0
- package/package.json +32 -0
package/README.md
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# @alucify/mcp
|
|
2
|
+
|
|
3
|
+
Lightweight MCP server that gives Claude Code read-only access to your project's [Alucify](https://github.com/alucifyai/alucify-vs-extension) appgraph — a structured model tracing requirements through implementations to validations.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
Add to your project's `.mcp.json`:
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
{
|
|
11
|
+
"mcpServers": {
|
|
12
|
+
"alucify": {
|
|
13
|
+
"command": "npx",
|
|
14
|
+
"args": ["@alucify/mcp"]
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Requires a `.alucify/` directory with an appgraph (generated by `alucify analyze-code` or committed by a teammate).
|
|
21
|
+
|
|
22
|
+
## Tools
|
|
23
|
+
|
|
24
|
+
| Tool | Description |
|
|
25
|
+
|------|-------------|
|
|
26
|
+
| `query_context` | Search nodes by type, name, subtype, or status |
|
|
27
|
+
| `get_context` | Full node detail with DSL definitions and connected nodes |
|
|
28
|
+
| `trace_dependencies` | Blast radius analysis for file changes |
|
|
29
|
+
| `get_remaining_work` | Unimplemented requirements, untested validations |
|
|
30
|
+
| `diff_context` | Compare two versions |
|
|
31
|
+
| `get_analysis` | Congruency, coverage, and quality report summaries |
|
|
32
|
+
| `link_context` | Link a node to its implementation file for progress tracking |
|
|
33
|
+
|
|
34
|
+
## How It Works
|
|
35
|
+
|
|
36
|
+
The MCP server starts as a subprocess when Claude Code connects. It reads `.alucify/appgraph-project.json` on each tool call (cached for 5 seconds). All operations are read-only.
|
|
37
|
+
|
|
38
|
+
For the full tool reference and CLAUDE.md setup, see the [MCP Server documentation](https://github.com/alucifyai/alucify-vs-extension/blob/main/docs/mcp-server.md).
|
|
39
|
+
|
|
40
|
+
## Related
|
|
41
|
+
|
|
42
|
+
- [`@alucify/cli`](https://www.npmjs.com/package/@alucify/cli) — CLI with analysis, commit tracking, and Claude Code integration (`npx @alucify/cli`)
|
|
43
|
+
- [Alucify VS Code Extension](https://marketplace.visualstudio.com/items?itemName=alucify.alucify-vscode) — Full UI with dashboard, visualizer, and chat
|
|
44
|
+
- `alucify mcp-install` — CLI command that vendors the MCP server into `.alucify/` for zero-install team sharing
|