MCP server that gives AI agents (Claude, Cursor, Copilot) deep understanding of your codebase patterns, conventions, and architecture. Query patterns, security boundaries, call graphs in real-time.
npm install driftdetect-mcpMCP (Model Context Protocol) server that gives AI agents deep understanding of your codebase patterns, conventions, and architecture.
Recommended: Global install with pinned version
``bash`
npm install -g driftdetect-mcp@0.9.23
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
`json`
{
"mcpServers": {
"drift": {
"command": "driftdetect-mcp"
}
}
}
Add to your MCP config:
`json`
{
"mcpServers": {
"drift": {
"command": "driftdetect-mcp"
}
}
}
`json`
{
"mcpServers": {
"drift": {
"command": "npx",
"args": ["-y", "driftdetect-mcp@0.9.23"]
}
}
}
Scan your project first:
`bash`
cd /path/to/your/project
npx driftdetect init
npx driftdetect scan
- Reads: Source files in your project directory
- Writes: .drift/ directory onlydrift telemetry disable
- Network: No outbound calls (all analysis is local)
- Telemetry: Anonymous usage stats, opt-out with
45+ MCP tools organized in 7 layers:
| Layer | Key Tools | Purpose |
|-------|-----------|---------|
| Orchestration | drift_context | Start here - curated context for any task |drift_status
| Discovery | , drift_capabilities | Quick overview |drift_signature
| Surgical | , drift_callers, drift_type | Precise queries |drift_patterns_list
| Exploration | , drift_security_summary | Browse patterns |drift_pattern_get
| Detail | , drift_code_examples | Deep dives |drift_test_topology
| Analysis | , drift_coupling | Code health |drift_validate_change
| Generation | , drift_suggest_changes | AI assistance |
`
You: "Add a user preferences endpoint"
AI calls drift_context({ intent: "add_feature", focus: "user preferences" })
Drift returns:
- Your API patterns (decorators, prefixes, response format)
- Similar endpoints as examples
- Required middleware
- Files to modify
- Security considerations
``
- Full Documentation
- MCP Tools Reference
- MCP Setup Guide
Apache 2.0 - See LICENSE