Flashcard MCP Server

Spaced repetition flashcard app with SM-2 algorithm, multiple decks, flip animations, and mastery tracking.

Features

• SM-2 Spaced Repetition Algorithm - Scientifically-proven algorithm for optimal review scheduling, adjusting intervals based on card difficulty and performance
• Multiple Decks - Pre-loaded decks covering JavaScript Fundamentals, Git Commands, and HTTP Status Codes
• Mastery Tracking - Cards progress through learning, reviewing, and mastered states with automatic advancement based on performance
• Flip Animations - Interactive card flip animations for engaging study experience
• Study Statistics - Real-time tracking of reviews, streak days, ease factors, and mastery breakdown
• Ease Factor Adjustment - Dynamic difficulty scoring that adapts to your performance on each card

Installation

npm install @gongrzhe/server-flashcard

Usage

As a CLI

npx @gongrzhe/server-flashcard

Claude Desktop Configuration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "flashcard": {
      "command": "npx",
      "args": ["-y", "@gongrzhe/server-flashcard"]
    }
  }
}

Claude Code Configuration

claude mcp add flashcard -- npx -y @gongrzhe/server-flashcard

Tools

get-flashcard-deck

Returns a built-in flashcard deck with cards for studying.

Parameters:

• topic (optional) - Topic for the deck: 'javascript', 'git', or 'http'. Defaults to 'javascript'.

Returns:

• Deck name and description
• List of flashcards with front/back content and difficulty levels
• Total card count

submit-review

Submit a review rating for a flashcard. Uses the SM-2 spaced repetition algorithm to compute the next review interval.

Parameters:

• cardId - The ID of the card being reviewed
• rating - Rating from 1 (Again) to 5 (Easy)
• responseTimeMs - Time in milliseconds the user took to respond

Returns:

• Next review date
• Review interval in days
• Updated ease factor
• Current mastery level (learning, reviewing, mastered)

get-stats

Returns study statistics including mastery breakdown, average ease factor, streak, and reviews today.

Parameters:

• deckId (optional) - Deck ID to get stats for. Defaults to all decks.

Returns:

• Total card count
• Breakdown by mastery level (mastered, reviewing, learning)
• Average ease factor
• Current streak days
• Reviews completed today

Example Prompt

Load the JavaScript fundamentals flashcard deck and start studying

Built-in Decks

JavaScript Fundamentals

10 cards covering core JavaScript concepts including closures, prototypes, async patterns, and ES6+ features.

Git Commands

8 cards covering essential Git commands for version control, branching, merging, and collaboration.

HTTP Status Codes

10 cards covering common HTTP status codes, their meanings, and when they are used in web applications.

License

MIT