Home
Login
rember/rember-mcp

A Model Context Protocol (MCP) server for Rember, allowing Claude to create flashcards for you, helping you learn and memorize any important content through spaced repetition.

MITTypeScript 42rember Last Updated: 2025-03-28
https://github.com/rember/rember-mcp

Rember MCP Project Detailed Introduction

Project Overview

Rember MCP is a server based on the Model Context Protocol (MCP), specifically designed for the Rember learning platform. This project allows the Claude AI assistant to directly create flashcards for users, helping them learn and memorize important content through a scientific spaced repetition algorithm.

MCP (Model Context Protocol) is an official protocol used to connect AI assistants with external tools and services. Rember MCP leverages this protocol to achieve seamless integration between Claude and the Rember learning platform.

Core Features and Functionality

Main Features

  1. Intelligent Flashcard Generation

    • Automatically extracts key information from chat conversations to create flashcards.
    • Supports flashcard generation from PDF documents.
    • Utilizes AI technology to optimize the organization and presentation of learning content.
  2. Spaced Repetition Learning System

    • Arranges review schedules based on a scientific spaced repetition algorithm.
    • Helps users retain important knowledge points in long-term memory.
    • Personalized learning progress tracking.
  3. Multiple Trigger Methods

    • "I like your answer, help me remember it"
    • "Create flashcards from Chapter 2 of this PDF"
    • "Help me remember this"
    • "Add to Rember"
    • "Create some flashcards"

Technical Features

  • Easy Installation: One-click execution via npx command.
  • API Integration: Deep integration with the Rember official API.
  • Claude Desktop Support: Perfectly compatible with the Claude Desktop application.
  • Error Handling: Built-in retry mechanism and error handling.
  • Debugging Friendly: Supports stderr log output.

Usage Instructions

Installation and Configuration

  1. Run the MCP Server

    npx -y @getrember/mcp --api-key=YOUR_REMBER_API_KEY
    
  2. Configure Claude Desktop Add the following to the claude_desktop_config.json file:

    {
      "mcpServers": {
        "rember": {
          "command": "npx",
          "args": ["-y", "@getrember/mcp", "--api-key=YOUR_REMBER_API_KEY"]
        }
      }
    }
    
  3. Obtain API Key

    • Visit Rember
    • API key format: rember_ + 32 random characters

Use Cases

  • Learning New Concepts: After a conversation with Claude, simply say "Help me remember this."
  • Document Learning: Upload a PDF file and request "Create flashcards from Chapter X."
  • Knowledge Organization: Convert important conversation content into reviewable learning materials.

Development Experience and Best Practices

The project team has accumulated valuable experience during development:

Technical Aspects

  • Early Setup of Logging: Configure stderr logs as early as possible, which is crucial for debugging.
  • Start Simple: First create a simple MCP tool to verify that Claude can call it correctly.
  • Perfect Tool Descriptions: Invest time in optimizing tool descriptions, including product details, usage examples, etc.
  • Strategic Response Design: Design tool call responses strategically to help Claude better understand the results.

User Experience

  • Clear Usage Guide: Provide detailed installation and configuration instructions.
  • Diverse Trigger Words: Support various natural language expressions.
  • Error Handling Optimization: Provide upgrade prompts for users who have reached their monthly limit.

Technical Architecture

  • Protocol: Model Context Protocol (MCP)
  • Runtime Environment: Node.js (via npx)
  • API Integration: Rember Official API
  • Main Tool: create_flashcards - Intelligent flashcard creation
  • Error Handling: Supports transient error retries and timeout handling

Project Status and Future Plans

Current Features

  • ✅ Basic flashcard creation
  • ✅ PDF content processing
  • ✅ Claude Desktop integration
  • ✅ Basic error handling

To-Be-Improved Items

  • 🔄 Telemetry and observability features
  • 🔄 More comprehensive error handling mechanisms
  • 🔄 Further optimization of tool descriptions
  • 🔄 More automated test coverage

Summary

Rember MCP is an innovative learning tool that cleverly combines the conversational capabilities of AI assistants with scientific learning methods. Through the MCP protocol, users can seamlessly transform conversations with Claude into structured learning materials and utilize spaced repetition algorithms for long-term memory.