codeparse MCP server
Commit Nov 13, 2026Indexes Python codebases into a local SQLite database to provide agents with compact context and reduced token usage.
Also known as cmgoffena13/codeparse
- Stars
- 1
- Tools
- 9
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 13, 2026
- License
- MIT
What is codeparse MCP?
codeparse indexes Python codebases into a local SQLite database to provide agents with compact context and reduced token usage. It exposes 9 tools, such as get_entry_points, get_directory_tree, get_file_symbol_tree.
Summary generated from the project's README
About codeparse MCP server
Indexing Python codebases into a local SQLite database allows AI agents to access compact context while minimizing token consumption. This server parses your code to map relationships and stores them locally, making it an efficient way for developers to provide large repositories to LLMs without overwhelming the context window.
Users set up the server by placing the codeparse binary on their PATH and running the install command. Once active, the server provides specific tools like get_symbol, search_symbols, and get_import_relations to help agents navigate complex structures. It also includes a guided exploration skill and a resource to track tokens saved during a session.
Developers can manage the index using commands such as reload to reprocess a workspace or update to refresh the binary. By using tools like get_file_symbol_tree and list_subclasses, an agent can understand class hierarchies and module dependencies through the structured SQLite backend rather than reading every line of raw text.
Written from the project's README. Every use case is checked against a quote from it.
codeparse MCP tools 9
Detected from the READMEget_entry_pointsget_directory_treeget_file_symbol_treeget_symbolget_symbol_at_linesget_symbol_relationsget_import_relationssearch_symbolslist_subclasses
| get_entry_points | — | |
| get_directory_tree | — | |
| get_file_symbol_tree | — | |
| get_symbol | — | |
| get_symbol_at_lines | — | |
| get_symbol_relations | — | |
| get_import_relations | — | |
| search_symbols | — | |
| list_subclasses | — |
README
View on GitHubCodeParse is a codebase indexer that gives agents fast, accurate, and compact context on your Python codebases while reducing token usage. It parses your codebase and stores the relationships of your code in a local SQLite database.
Install MCP Server and Skill
- Put the
codeparsebinary on your PATH (release asset ormake compile→dist/codeparse). codeparse install
Tools
| Tool | Description |
|---|---|
get_entry_points |
Return the project entry points. |
get_directory_tree |
Return the directory tree. |
get_file_symbol_tree |
Return the symbol tree of one file. |
get_symbol |
Return one symbol's definition with dependent and dependency counts. |
get_symbol_at_lines |
Return the symbol that covers a line range in a file. |
get_symbol_relations |
Return dependents or dependencies for one symbol. |
get_import_relations |
Return dependents or dependencies for one module. |
search_symbols |
Full Text Search symbol names. |
list_subclasses |
Return the classes that directly inherit from a class. |
Resources
| Resource | Description |
|---|---|
skill://codeparse/SKILL.md |
Guided exploration skill for navigating Python codebases. |
stats://codeparse/sessions |
Per-session markdown table of files with tool calls and a tokens-saved range. |
Commands
| Command | Description |
|---|---|
install |
Register the MCP server in installed clients and write the skill. |
uninstall |
Remove the codeparse MCP server, skill, and indexes. |
update |
Replace the binary with the latest release (--version optional) and update the skill. |
mcp |
Start the MCP server. |
reload |
Drop the index and reprocess the workspace ad-hoc |
Benchmark Evaluation
In-Progress
Ten questions found in eval/tasks.json are evaluated against the SQLMesh repo using a baseline agent and an agent with the CodeParse MCP server and skill.
| Model | Baseline Avg Tokens | CodeParse Avg Tokens | Token Reduction |
|---|---|---|---|
| Grok 4.7 High Fast | 185,371 | 119,572 | -35% |
| Opus 5.5 Medium | ... | ... | ... |
Running the Evaluation
Cursor Default Model: grok 4.7
Claude Defualt Model: opus 5.5 medium
make eval-smoke cursorwill run all 10 questions and evaluate.make eval cursorwill run all 10 questions on repeat (10 times) and evaluate.
codeparse MCP questions
What tools does codeparse MCP provide?
It exposes 9 tools, including get_entry_points, get_directory_tree, get_file_symbol_tree, get_symbol, get_symbol_at_lines.
How does CodeParse store code relationships?
It parses your codebase and stores the relationships of your code in a local SQLite database.
Can I remove the server and its indexes?
Yes, you can use the uninstall command to remove the MCP server, skill, and indexes.