MCP cover image
See in Github
2025-04-14

0

Github Watches

0

Github Forks

0

Github Stars

Flashcards MCP

A Go-based implementation of a spaced repetition flashcard system using the Model Context Protocol (MCP). This allows AI assistants and other systems to leverage spaced repetition for knowledge retention.

Features

  • Comprehensive API for managing flashcards through the Model Context Protocol
  • Implementation of the Free Spaced Repetition Scheduler (FSRS) algorithm for optimized review scheduling
  • Persistent storage of flashcard data and review history across sessions
  • Support for tagging and filtering cards

Installation

Prerequisites

  • Go 1.19 or later
  • Access to an MCP-compatible client (e.g., Claude Desktop, Anthropic Claude in Console)

Building from Source

# Clone the repository
git clone https://github.com/danieldreier/mcp-flashcards.git
cd mcp-flashcards

# Build the flashcards executable
go build -o cmd/flashcards/flashcards ./cmd/flashcards

Configuration

Claude Desktop Configuration

To ensure your flashcards persist across sessions in Claude Desktop, you need to configure the MCP server with an absolute path for the storage file.

Create or edit your MCP configuration in Claude Desktop:

  1. Open Claude Desktop
  2. Go to Settings → MCP
  3. Add the flashcards MCP server with an absolute file path:
{
  "mcpServers": {
    "Flashcards": {
      "command": "/path/to/mcp-flashcards/cmd/flashcards/flashcards",
      "args": ["-file", "/absolute/path/to/store/flashcards-data.json"]
    }
  }
}

Example (using home directory):

{
  "mcpServers": {
    "Flashcards": {
      "command": "/Users/yourusername/go/src/github.com/danieldreier/mcp-flashcards/cmd/flashcards/flashcards",
      "args": ["-file", "/Users/yourusername/flashcards-data.json"]
    }
  }
}

Important: The default configuration uses a relative path (./flashcards.json), which depends on the current working directory when Claude Desktop launches the MCP. Using an absolute path ensures your flashcards are saved to and loaded from the same location regardless of the working directory.

Usage

Once configured, you can use the flashcards MCP with Claude Desktop. Here are some example prompts:

Creating Cards

Use the Flashcards MCP to create a new flashcard:
Front: What is the capital of France?
Back: Paris
Tags: geography, europe

Reviewing Cards

Use the Flashcards MCP to get my next due card for review.

After seeing the card:

I recall the answer is Paris. Rate this card as "Good" (3).

Listing Cards

Use the Flashcards MCP to list all my flashcards with the tag "geography".

Available MCP Tools

The Flashcards MCP provides the following tools:

  1. get_due_card: Returns the next card due for review
  2. submit_review: Records a review with rating (1-4) for a card
  3. create_card: Creates a new flashcard
  4. update_card: Updates an existing flashcard
  5. delete_card: Deletes a flashcard
  6. list_cards: Lists flashcards, optionally filtered by tags

Troubleshooting

Cards Not Persisting Between Sessions

If your cards aren't being saved between sessions:

  1. Verify you're using an absolute path for the storage file in your MCP configuration
  2. Check that the directory for the storage file exists and is writable
  3. Confirm your Claude Desktop configuration is correctly formatted
  4. Check that the path to the executable is correct

Running Tests

To verify persistence is working correctly:

cd cmd/flashcards
go test -v -run TestPersistenceAcrossSessions

License

MIT License

相关推荐

  • Aurity Ltd
  • Create and Publish Business Websites in seconds. AI will gather all the details about your website and generate link to your website.

  • John Rafferty
  • Text your favorite pet, after answering 10 questions about their everyday lives!

  • Convincible Ltd
  • You're in a stone cell – can you get out? A classic choose-your-adventure interactive fiction game, based on a meticulously-crafted playbook. With a medieval fantasy setting, infinite choices and outcomes, and dice!

  • Ian O'Connell
  • Provide players' names or enter Quickstart to start the game!

  • Matthieu Savioux
  • Evaluates language quality of texts, responds with a numerical score between 50-150.

  • analogchat.com
  • Efficient Spotify assistant for personalized music data.

  • seabiscuit.ai
  • Discover A More Robust Business: Craft tailored value proposition statements, develop a comprehensive business model canvas, conduct detailed PESTLE analysis, and gain strategic insights on enhancing business model elements like scalability, cost structure, and market competition strategies. (v1.18)

  • Carl Oscar Aaro
  • Structured recipes for food and desserts – ingredient lists and step-by-step recipe instructions from any input. Become surprised, try something new or breathe life into grandma's old recipe notebook.

  • WangRongsheng
  • 🧑‍🚀 全世界最好的 llM 资料总结(数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型) | Resumen de los mejores recursos del mundo.

  • av
  • Ejecute sin esfuerzo LLM Backends, API, frontends y servicios con un solo comando.

  • 1Panel-dev
  • 🔥 1Panel proporciona una interfaz web intuitiva y un servidor MCP para administrar sitios web, archivos, contenedores, bases de datos y LLM en un servidor de Linux.

  • Azure
  • Este repositorio es para el desarrollo del servidor Azure MCP, llevando el poder de Azure a sus agentes.

  • langgenius
  • alibaba
  • caio-moliveira
  • Este proyecto fue creado para demostrar cómo podemos conectarnos con diferentes protocolos de contexto del modelo (MCP).

  • rulego
  • ⛓️Rulego es un marco de motor de regla de orquestación de componentes de alta generación de alto rendimiento, de alto rendimiento y de alto rendimiento para GO.

  • Byaidu
  • Traducción de papel científico en PDF con formatos preservados - 基于 Ai 完整保留排版的 PDF 文档全文双语翻译 , 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 等服务 等服务 等服务 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 cli/mcp/docker/zotero

    Reviews

    3.6 (7)
    Avatar
    user_GQpmwHaz
    2025-04-24

    I've been using mcp-flashcards by danieldreier and it's an incredible tool! The app is straightforward and user-friendly, making studying efficient and enjoyable. With comprehensive features and a seamless interface, it's perfect for anyone looking to enhance their learning through flashcards. Highly recommend it!

    Avatar
    user_5MLpTDPx
    2025-04-24

    I've been using mcp-flashcards by danieldreier for a while now, and it's simply fantastic. The user interface is intuitive, and the flashcards have greatly improved my retention. The platform is perfect for anyone looking to boost their learning efficiency. Highly recommend this tool!

    Avatar
    user_yzkGxbxr
    2025-04-24

    As an avid user of mcp-flashcards by danieldreier, I can confidently say this tool is a game-changer for learning and retention. Its intuitive design and ease of use make it ideal for anyone looking to improve their study habits. The seamless integration into my daily routine has boosted my productivity and made learning enjoyable. Highly recommend!

    Avatar
    user_YNEFEQbN
    2025-04-24

    I’ve been using mcp-flashcards by danieldreier for a while now, and it has significantly improved my study sessions. The interface is user-friendly, and the flashcards are effective for memorization and review. Highly recommend it for anyone looking to enhance their learning experience!

    Avatar
    user_ALyArSpY
    2025-04-24

    I have been using mcp-flashcards by danieldreier and it has significantly boosted my learning experience! The interface is user-friendly, and the flashcards are well-organized and cover a wide range of topics. It's a must-have tool for anyone looking to improve their study efficiency. Highly recommend it!

    Avatar
    user_q3iKWJfF
    2025-04-24

    I've been using mcp-flashcards by danieldreier to study and it's been a game-changer. The interface is user-friendly and the customizable flashcards make retaining information a breeze. It's evident that a lot of thought went into developing this app. Highly recommend it to anyone looking to enhance their learning process!

    Avatar
    user_NJRBiEVp
    2025-04-24

    As an avid user of mcp-flashcards by danieldreier, I must say this tool is a game-changer! It's efficient and user-friendly, making studying a breeze. The seamless interface and well-organized structure help in quick learning and retention. Highly recommended for anyone looking to enhance their learning process.