sove-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sove-mcp Analyze the dependency graph and find circular dependencies in my project."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sove-mcp
An MCP server that gives Claude structural understanding of a codebase — dependency graph, entry points, complexity ranking and import cycles — without reading every file into context.
Why
Claude can already read files. But answering "what are the entry points, and which five modules are most complex?" means pulling the whole repository into the context window. On a 145-file application that is tens of thousands of tokens, most of it irrelevant.
This computes the answer locally and returns a few hundred tokens:
{
"files": 35,
"dependencyEdges": 83,
"circularDependencies": 0,
"entryPoints": [{ "file": "cli/index.ts", "dependencies": 5 }],
"mostComplex": [
{ "file": "phases/phase2-ghostwriter/test-generator.ts", "cyclomatic": 105, "cognitive": 95 }
]
}Built on sove-toolkit, which resolves
CommonJS require(), ESM imports, and TypeScript path aliases (@/components/Button).
Related MCP server: code-context
Install
npm install -g sove-mcpAdd to your MCP client config. For Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"sove": {
"command": "sove-mcp",
"env": {
"SOVE_MCP_ALLOWED_ROOTS": "/path/to/your/projects"
}
}
}
}For Claude Code:
claude mcp add sove -e SOVE_MCP_ALLOWED_ROOTS=/path/to/your/projects -- sove-mcpTools
Tool | Returns |
| Full summary: files, edges, entry points, cycles, complexity |
| Modules nothing imports — where execution starts |
| Import cycles, via Tarjan's algorithm, with severity |
| Cyclomatic and cognitive complexity ranking |
| Writes JSDoc into source files — opt-in only, see below |
All tools take a directory. Everything except the last is read-only and annotated as
such, so clients can surface that to the user.
Security
An MCP server runs with the privileges of whoever launched it, and the model decides what to call. Two defaults follow from that:
Reads are confined to allowed roots. SOVE_MCP_ALLOWED_ROOTS (path-separator
delimited) defines what the server may read; it defaults to the working directory. Paths
are compared with path.relative, not string prefixes — /data-private starts with
/data as a string but is not inside it, and a prefix check would let it through.
Nothing writes unless you opt in. generate_documentation modifies source files, so
it is not registered at all unless SOVE_MCP_ALLOW_WRITES=true. A default install cannot
alter your files regardless of what the model is asked to do.
SOVE_MCP_ALLOWED_ROOTS="/home/me/work:/home/me/side" SOVE_MCP_ALLOW_WRITES=true sove-mcpDevelopment
npm install
npm test # 12 tests, driven over real stdio JSON-RPC
npm startThe tests spawn the actual server process and speak JSON-RPC to it rather than calling handlers directly — that is the only way to catch schema-registration, transport and startup faults, which is where servers like this actually break.
Licence
MIT
Available Tools
4 toolsanalyze_repositoryAnalyse repositoryARead-only
Builds a dependency graph for a codebase and returns a summary: file count, import edges, entry points, circular dependencies and the most complex modules. Use this instead of reading every file when you need architectural context.
Inputs: directory (required).
find_circular_dependenciesFind circular dependenciesARead-only
Detects import cycles using Tarjan's algorithm. Returns each cycle with a severity based on how many modules it spans.
Inputs: directory (required).
find_entry_pointsFind entry pointsARead-only
Lists the modules nothing else imports — where execution starts. Useful for orienting in an unfamiliar codebase before reading any source.
Inputs: directory (required).
most_complex_filesMost complex filesARead-only
Ranks modules by cyclomatic complexity so you can find refactoring targets without reading the codebase.
Inputs: directory (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct analysis aspect, but analyze_repository overlaps by summarizing entry points, cycles, and complexity, which are also covered by the specialized tools. The descriptions clarify that the summary is high-level, while the other tools provide deeper dives.
Three tools use verb_noun naming (analyze_repository, find_entry_points, find_circular_dependencies), but most_complex_files is an adjective phrase, breaking the pattern. All names use snake_case, maintaining readability despite the inconsistency.
Four tools is well-scoped for a code analysis server, falling within the ideal 3-15 range. Each tool serves a distinct purpose in architectural analysis, and the count feels neither thin nor bloated.
The set covers the key aspects of codebase analysis: overall summary, entry points, circular dependencies, and complexity. Minor gaps exist (e.g., dependency depth, module coupling), but the core workflows for architectural understanding are complete.
Maintenance
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Repository knowledge graph MCP server for codebase understanding and debugging.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives Claude Desktop complete intelligence about any public GitHub repository. Research libraries, compare packages, audit dependencies, and explore codebases through natural conversation.1MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides dynamic codebase context to Claude Code through tools like hybrid search, recent changes, and symbol definitions, enhancing AI-assisted coding with local RAG.839 PyPIMIT
- AlicenseAqualityDmaintenanceA read-only MCP server that lets a Claude chat explore your local repository and answer questions about it, returning synthesized answers with file:line references.31MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that gives Claude Code a curated atlas of your codebase, fusing LSP-grade structure with architectural intent from ADRs, git history, and test associations for single-call context bundles.72 npm7MIT