MCP server for tracking DSA/LeetCode practice with spaced repetition. Ships with NeetCode 150, supports any custom problem list.
Project description
dsa-tracker-mcp
mcp-name: io.github.ashmitrrr/dsa-tracker-mcp-server
This is an MCP server for tracking your progress through your DSA questions and comes loaded with a default list of Neetcode 150 (any custom DSA problem list can be switched per user) with built-in spaced repetition. Built with FastMCP and SQLite.
Talk to it naturally from Claude: "what should I work on next", "log that I solved Two Sum, confidence 4, took 12 minutes", "how's my progress", "show me my history on Contains Duplicate".
Features
- Spaced repetition — problems you struggle with come back sooner, problems you nail come back later. Schedule is based on how you rated each attempt (gave up / struggled / solved) and your confidence (1-5).
- List-agnostic — ships with the full NeetCode 150 (150 problems, 18 categories) but can load any custom problem list via a JSON file.
- Fuzzy matching — log an attempt with a loosely-typed problem name ("two sum", "contains dupe") and it'll match the right problem.
- Stats & streaks — solved counts, per-category breakdown, daily streak, total time spent.
Tools
| Tool | Description |
|---|---|
log_attempt |
Log an attempt at a problem (status, confidence 1-5, time spent). Schedules the next review. |
get_next_problem |
Get what to work on next: an overdue review, or the next new problem in order. Optional category filter. |
get_stats |
Overall progress summary — solved counts, per-category breakdown, streak, total time. |
search_problems |
Search/filter problems by name, category, difficulty, or status. |
get_problem_history |
All logged attempts for a given problem, chronological. |
Resources
dsa://progress— current progress snapshotdsa://problem-list— full list of tracked problems
Prompts
daily_review— generates a daily review session based on what's dueexplain_pattern(category)— explains the core pattern/approach for a given category
Installation
git clone https://github.com/ashmitrrr/dsa-tracker-mcp.git
cd dsa-tracker-mcp
python3 -m venv .venv
source .venv/bin/activate # on Windows: .venv\Scripts\activate
pip install -r requirements.txt
Configuration
Claude Desktop
Add to your claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"dsa-tracker": {
"command": "/absolute/path/to/dsa-tracker-mcp/.venv/bin/python",
"args": ["/absolute/path/to/dsa-tracker-mcp/server.py"]
}
}
}
Restart Claude Desktop completely after saving.
Environment variables (optional)
| Variable | Default | Description |
|---|---|---|
DSA_TRACKER_DB |
~/.dsa_tracker_mcp/progress.db |
Path to the SQLite database |
DSA_TRACKER_PROBLEMS_FILE |
(none, uses built-in NeetCode 150) | Path to a JSON file with a custom problem list |
Custom problem list format
[
{
"name": "Two Sum",
"category": "Arrays & Hashing",
"difficulty": "Easy",
"url": "https://leetcode.com/problems/two-sum/"
}
]
url and difficulty are optional and will be auto-filled where possible. order_index is assigned automatically based on list order.
Spaced repetition logic
| Outcome | Next review |
|---|---|
| Gave up | 1 day |
| Struggled, confidence ≤ 2 | 2 days |
| Struggled, confidence ≥ 3 | 4 days |
| Solved, confidence ≤ 3 | 7 days |
| Solved, confidence ≥ 4 | 21 days |
get_next_problem prioritizes overdue reviews before suggesting new problems.
Example prompts
- "What should I work on next?"
- "I just solved Valid Anagram, confidence 5, took 6 minutes, log it"
- "How's my progress on Trees?"
- "Show me my history on Two Sum"
- "Give me a daily review"
License
MIT — see LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dsa_tracker_mcp-1.0.1.tar.gz.
File metadata
- Download URL: dsa_tracker_mcp-1.0.1.tar.gz
- Upload date:
- Size: 13.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ce64e995c456afbaf01280ae139414f3ff7fcfd63be7b3e0651f6a19fc81eb07
|
|
| MD5 |
42de9eb0e89e18ff4b03f95ff618be01
|
|
| BLAKE2b-256 |
770df27f6fded4e95422f0705b26538348c60963ab29c67c5944f16c98687226
|
File details
Details for the file dsa_tracker_mcp-1.0.1-py3-none-any.whl.
File metadata
- Download URL: dsa_tracker_mcp-1.0.1-py3-none-any.whl
- Upload date:
- Size: 15.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c6a9c8a092597ac23757575fb97a13dbf60cd1b7e2dae493678deb8db4691fcb
|
|
| MD5 |
689f2aead2fd5768d84aa90fd2e9d911
|
|
| BLAKE2b-256 |
370cdb01eb9c8d1d50815e35a8ebf06ad1e6245a8637abc511b6c4820943f22e
|