MCP Server
Connect Mikk to Claude Desktop, Cursor, and VS Code Copilot. 18 tools, 3 resources, millisecond responses - all grounded in your real codebase graph.
Every tool reads from mikk.lock.json
No re-parsing on every call. Response times are fast because the dependency graph, hashes, and indexes are precomputed and stored on disk.
Quick Start
mikk mcp # start the server
mikk mcp install # auto-detect and install into Claude/Cursor/VS Code
mikk mcp install --tool claude # install into Claude Desktop specificallyConnecting AI Assistants
Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or
~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"mikk": {
"command": "npx",
"args": ["-y", "@getmikk/mcp-server", "/absolute/path/to/your/project"]
}
}
}{
"mcpServers": {
"mikk": {
"command": "npx",
"args": ["-y", "@getmikk/mcp-server", "/absolute/path/to/your/project"]
}
}
}mikk mcp install --tool vscodeStaleness Warning (Context Drift)
If your lock file is out of sync with the source (drifted), tools return a warning field.
Refresh with mikk analyze, or keep it updated continuously with mikk watch.
Tools Reference
Project Overview
Prop
Type
Understanding The Codebase
Prop
Type
Safe Edits (Middleman Tools)
Prop
Type
Reading Files
Prop
Type
Constraints, ADRs, Health
Prop
Type
Routes
Prop
Type
Resources
| Resource | URI | Description |
|---|---|---|
| Contract | mikk://contract | Full mikk.json contract as JSON |
| Lock file | mikk://lock | Full mikk.lock.json as JSON |
| Context | mikk://context | Current claude.md content |
Recommended Workflow
1) Start: mikk_get_session_context
2) Before editing: mikk_before_edit(["src/whatever.ts"])
3) Impact: mikk_impact_analysis({ file: "src/whatever.ts" })
4) Understanding: mikk_query_context({ question: "How does X work?", tokenBudget: 6000 })Middleman > giant pastes
The lock file can be large. Instead of pasting it, keep it fresh with mikk analyze or mikk watch,
then let the assistant call focused tools like mikk_before_edit and mikk_impact_analysis when it needs specifics.
Was this page helpful?