Mirofy — Claude Code MCP server: repository maps
Mirofy turns repository relationships into an HTML diagram with file, line and commit evidence. Use it to trace dependencies and see which files its analysis could not read.
claude mcp add mirofy -- npx -y mirofy-cliWhat Mirofy does
Mirofy reads supported sources, builds a graph of repository relationships, then renders an HTML diagram. You can search the result and inspect the file, line range and commit behind a connection. When it cannot support a relationship with evidence, the diagram leaves that gap visible.
The MCP server drives the same CLI as npx mirofy-cli map .. It reads imports in JavaScript, TypeScript, Python, Go, Java, Rust and Kotlin, along with package.json workspaces, Express and Next routes, and docker-compose. Files no adapter reads are listed in coverage.md. Mapping requires a Git repository with a commit, since each finding needs a revision to cite.
What it helps with
- create an HTML architecture map from a repository
- trace imports between packages or source directories
- check which files and commits support a relationship
- find files left out of the analysis
Example prompts for the agent
- Map this repository's architecture and show the evidence behind its connections.
- Trace which packages import this module, with the relevant files and lines.
- Check analysis coverage and list files left out of the map.
How to install Mirofy
Platform CLI
claude mcp add mirofy -- npx -y mirofy-cliPlatform CLI
codex mcp add mirofy -- npx -y mirofy-cliConfig file
{
"mcpServers": {
"mirofy": {
"command": "npx",
"args": [
"-y",
"mirofy-cli"
]
}
}
}Config file
{
"servers": {
"mirofy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mirofy-cli"
]
}
}
}Platform CLI
gemini mcp add mirofy npx -y mirofy-cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Mirofy
How do I install Mirofy in Claude Code?
Run claude mcp add mirofy -- npx -y mirofy-cli to add the Mirofy MCP server.
What does Mirofy do?
It creates an HTML view of repository relationships. Connections include the file, lines and commit supporting them.
Which languages and files can Mirofy analyze?
It reads imports in JavaScript, TypeScript, Python, Go, Java, Rust and Kotlin, plus package.json workspaces, Express and Next routes, and docker-compose.
