Skip to main content

MCP server for tracking DSA/LeetCode practice with spaced repetition. Ships with NeetCode 150, supports any custom problem list.

Project description

dsa-tracker-mcp

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 snapshot
  • dsa://problem-list — full list of tracked problems

Prompts

  • daily_review — generates a daily review session based on what's due
  • explain_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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dsa_tracker_mcp-1.0.0.tar.gz (13.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dsa_tracker_mcp-1.0.0-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

Details for the file dsa_tracker_mcp-1.0.0.tar.gz.

File metadata

  • Download URL: dsa_tracker_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 13.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for dsa_tracker_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ceed161fc9a1c5f2de78ef6e991585cb8f99c93dd57ad1da66dfeac90270b7e6
MD5 9067350bd89f6e2f84a26fbdc38032c4
BLAKE2b-256 bfa23055a9e7a6d5412848e437d5f4b5c445fc9b0b1824b7b051e877ea6fed5a

See more details on using hashes here.

File details

Details for the file dsa_tracker_mcp-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for dsa_tracker_mcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e82ac9654c4ea29b0742592e50f23c2f9474922ef8387ffbc17632dd8321f462
MD5 0f76720b474f341e3330c7d4c94f32ca
BLAKE2b-256 44e734ae7b3b36d9bda882c7b337deb2a743fb251217dcd6b6bbf15daf586a56

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page