English Français العربية

io.github.CloudCorpRecords/flashdeck

السجل الرسمي أخرى

Flashcard decks and spaced repetition via AnkiConnect: study, decks, notes, and stats.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @reneturcios/flashdeck
Claude Code 
claude mcp add flashdeck -- npx -y @reneturcios/flashdeck@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "flashdeck": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/flashdeck@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/flashdeck:0.1.0
Claude Code 
claude mcp add flashdeck -- docker run -i --rm ghcr.io/cloudcorprecords/flashdeck:0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "flashdeck": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/flashdeck:0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. flashdeck
  2. Install
  3. CLI
  4. MCP server
  5. Development
  6. License

flashdeck

flashdeck lets an agent study and manage Anki flashcards through a local Anki instance running AnkiConnect. It covers the review loop (due cards, presenting a card, rating it), decks, notes, tags, note types, and collection statistics — a labelled core subset of 20 tools from the 53 documented in the original Anki MCP spec.

Anki must be running with the AnkiConnect add-on installed. By default flashdeck talks to http://127.0.0.1:8765; set ANKICONNECT_URL to point elsewhere.

Install

npx @reneturcios/flashdeck check

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/flashdeck

The container defaults to the MCP server. Pass CLI arguments to use it as a CLI instead. Note the container still needs network access to the host's AnkiConnect endpoint.

CLI

flashdeck check           # probe AnkiConnect (deck list on success)
flashdeck decks           # list decks
flashdeck due [deck]      # due cards, optionally for one deck
flashdeck stats [deck]    # deck stats, or collection stats with no deck
flashdeck tags            # all tags
flashdeck models          # all note types
flashdeck sync            # sync with AnkiWeb
flashdeck --version

Most commands accept --json. Exit codes: 0 success, 1 error (the message names the AnkiConnect or validation problem), 2 usage error.

MCP server

npx -y @reneturcios/flashdeck mcp

MCP client configuration:

{
  "mcpServers": {
    "flashdeck": {
      "command": "npx",
      "args": ["-y", "@reneturcios/flashdeck", "mcp"]
    }
  }
}
Tools
ToolInputWhat it does
sync—Sync with AnkiWeb.
get_due_cardsdeck?, include_answer?Due cards, optional deck filter; answers omitted unless requested.
get_cardsdeck?, state?, include_answer?Cards filtered by state (due/new/learning/suspended/buried) and deck.
present_cardcard_idShow a card's question/front.
rate_cardcard_id, ease (1-4)Rate Again/Hard/Good/Easy and schedule next review.
listDecksinclude_stats?List decks, optional per-deck stats.
deckStatsdeckStatistics for one deck.
createDeckdeckCreate a deck (Parent::Child, max 2 levels).
addNotedeck_name, model_name, fields, tags?Create one note.
addNotesdeck_name, model_name, notesBatch-create up to 100 notes.
findNotesquerySearch notes with Anki query syntax.
notesInfonotesDetails for notes.
updateNoteFieldsnote_id, fieldsUpdate a note's fields.
deleteNotesnotes, confirm?Delete notes; refused without confirm: true.
getTags—All tags.
addTagsnotes, tagsAdd tags to notes.
removeTagsnotes, tagsRemove tags from notes.
modelNames—List note types.
modelFieldNamesmodel_nameField names for a note type.
collection_stats—Aggregated collection statistics.

Deck statistics are computed locally from per-state card searches; no statistics endpoint is assumed. When Anki is not running, tools return an error naming the failed AnkiConnect request rather than an empty result.

Development

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, fake fetch only, no live Anki
npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو io.github.CloudCorpRecords/flashdeck؟

Flashcard decks and spaced repetition via AnkiConnect: study, decks, notes, and stats.

كيف أثبّت io.github.CloudCorpRecords/flashdeck؟

يعمل على جهازك. في Claude Code: claude mcp add flashdeck -- npx -y @reneturcios/flashdeck@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CloudCorpRecords/flashdeck إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.CloudCorpRecords/flashdeck مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.CloudCorpRecords/flashdeck؟

ينشره CloudCorpRecords. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.