srs-mcp — 間隔反復、MCPサーバーとして

MCP対応のエージェント（Claude Code、Claude Desktop、その他のMCPホスト）に、毎セッション手作業でマークダウンテーブルから「今日の期限」を再導出する代わりに、実際に正しくスケジュールされた間隔反復メモリを提供します。SM-2（Anki/SuperMemoの背後にあるアルゴリズム）を4つの呼び出し可能なツールとして実装し、ローカルのSQLiteファイルにバックアップされています。アカウント不要、ネットワーク呼び出しなし、テレメトリなし — すべてはあなたのマシン上で動作します。

ステータス: プロトタイプ、まだどこにも公開されていません。 ローカルでビルド・検証済み（下記「検証方法」を参照）。このプロジェクト外の誰にもまだインストールされていません。バージョン0.2.0はプレリリースとして扱ってください。

なぜこれが存在するのか

マークダウンのチェックリストや語彙テーブルは、人々（およびそれを支援するエージェント）が復習すべきものを追跡する一般的な方法ですが、それらから実際のスケジュールを計算するものは何もありません — 「今日の期限」は結局推測になり、毎回目で再確認することになります。srs-mcpは欠けているピースです。小さくて本物のスケジューリングアルゴリズムをツールとして公開し、エージェントがフラッシュカード、面接質問、語彙、オンボーディングクイズなど、あらゆるものの復習状態を追跡できるようにします。プロンプトでSM-2を再実装する必要はありません。

4つのコアツール（無料、無制限、永久）

Proを入手

2つの追加ツールはProライセンスの背後にゲートされています — これがsrs-mcpがサブスクリプションやホスト型バックエンドの代わりに使用する無料/有料の分割です:

ライセンスの仕組み、具体的には: srs-mcpはEd25519秘密鍵でライセンスキーに署名します。その鍵はメンテナのマシンから決して離れません。このリポジトリには対応する公開鍵（license.py）のみが含まれており、署名を検証できますが偽造はできません。キーを購入し、SRS_LICENSE_KEY（環境変数）として設定するか、~/.srs-mcp/license.keyに保存すると、Proツールがロック解除されます — アカウント不要、電話確認なし、オフラインで動作します。完全なメカニズムとその明記された制限についてはlicense.pyを参照してください（短いバージョン: これはカジュアルなコピーを抑止するものであり、DRMではありません — オープンソースのPythonファイルのローカルコピーでチェックをパッチで除去することを止めるものは何もありません。このトレードオフの正直なバージョンについてはモジュールのdocstringを参照してください）。

ライブ購入リンクはまだ存在しません。 このセクションはメカニズムを説明しており、ビルド・テスト済み（test_license_gate.pyを参照）ですが、動作するストアではありません。購入フローが存在するようになったら、ここに記載されます。

インストール

Python 3.11+ が必要です。

git clone <repo-url>   # not yet public — see status note above
cd srs-mcp
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/srs-mcp       # runs the server on stdio

Claude Codeプラグインとして使用するには、Claude Codeをこのディレクトリ（または公開後はマーケットプレイスのリスト）に向けてください — .claude-plugin/plugin.json と .mcp.json はすでに設定されています。サーバーは SRS_DB_PATH を読み取るため、プラグインインストールのデータは更新後も保持されます（Claude Codeでは ${CLAUDE_PLUGIN_DATA}/srs.db、直接/手動実行では同じ場所の srs.db）。

検証方法

単に「インポートできる」だけではありません — 実際のMCPプロトコル上で実行されています:

• test_client.py は server.py をサブプロセスとして起動し（実際のMCPホストと同じ方法）、完全な追加/一覧/採点/一覧セッションを駆動し、テストハーネスの外部で結果のSQLite行を独立して再チェックします。

• test_license_gate.py はサーバーを3つの方法（ライセンスなし、有効なライセンス、改ざんされたライセンス）で起動し、ケース1と3で export_items / get_forecast が拒否され、ケース2で実際のデータを返すことを確認します — ライセンスチェックが実際のゲートであり、ノーオペレーションではないことを証明します。

• ingest_chinese_vocab.py と ingest_leetcode.py は、このプロジェクトのマークダウントラッカーから実際の add_item MCP呼び出しを介して実際の個人データ（中国語語彙114項目、完了したLeetCode問題16件）をシードする、動作する冪等な取り込みスクリプトです。直接SQLite書き込みではありません。

「ローンチ準備完了」への正直なギャップ — 切り上げなし

1. 公開リポジトリがありません。 すべての実際の配布経路（Claude Codeのコミュニティプラグインマーケットプレイス、GitHubリリース、MCPディレクトリリスト）は、これが公開git URLで到達可能である必要があります。このプロジェクトはローカルのみです。それを作成すること（GitHubリポジトリ、場合によってはアカウント）は、明示的なゴーアヘッドなしではこのプロジェクトの現在の自律性の範囲外です — 上記のすべては、それが与えられたときにコピーアンドプッシュアクションになるように準備されており、ビルドタスクではありません。

2. claude plugin validate に対して自己検証できません。 この開発環境には claude CLIやNode/npxがありません。プラグインマニフェストは、Anthropicのドキュメントを注意深く読み、彼ら自身の本番 marketplace.json と相互参照することで確認できる限りスキーマ準拠ですが、機械検証はされていません。

3. ライブ購入フローがありません。 ライセンスメカニズムは本物でテスト済みですが、実際の販売にするにはストアフロント（Ko-fi、Gumroadなど）が必要ですが、それはまだ存在しません — それはアカウント作成ステップであり、ゴーアヘッドなしではこのプロジェクトの自律性の範囲外です。

4. ライセンスの執行は誠実さに基づいており、改ざん防止ではありません、設計上および読み取り可能なPythonを出荷する性質上 — 上記の「Proを入手」セクションと license.py のdocstringを参照してください。

5. 認証/マルチテナントのストーリーがありません。 単一のローカルSQLiteファイル、単一ユーザー。現在の「あなたのマシンで動作する」モデルには問題ありませんが、ホスト型/チーム製品になるには実際の設計作業が必要です。

6. 外部検証がゼロです。 このプロジェクト外の誰もこれをインストールまたは使用していません。上記のすべての主張は「ビルドおよびテストされたとおりに動作する」であり、「人々がこれを望んでいる」ではありません。

ライセンス

MIT — LICENSE を参照してください。（Pro層の ライセンスキーメカニズム はコード自体のMITライセンスとは別です — 上記の「Proを入手」を参照してください。）