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

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 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.1.tar.gz (13.9 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.1-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

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

Hashes for dsa_tracker_mcp-1.0.1.tar.gz
Algorithm Hash digest
SHA256 ce64e995c456afbaf01280ae139414f3ff7fcfd63be7b3e0651f6a19fc81eb07
MD5 42de9eb0e89e18ff4b03f95ff618be01
BLAKE2b-256 770df27f6fded4e95422f0705b26538348c60963ab29c67c5944f16c98687226

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for dsa_tracker_mcp-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c6a9c8a092597ac23757575fb97a13dbf60cd1b7e2dae493678deb8db4691fcb
MD5 689f2aead2fd5768d84aa90fd2e9d911
BLAKE2b-256 370cdb01eb9c8d1d50815e35a8ebf06ad1e6245a8637abc511b6c4820943f22e

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