sweaConnector

自分のアルゴリズム学習リポジトリをClaudeに接続し、読み取り専用のAndroidビューアーとして焼き込むツール。

Claudeがあなたの学習リポジトリを直接読み書きします — 次に解く問題を選んでくれたり、スケジュールを調整したり、 解法ノートを記録したりします。その結果は、折りたたみ端末に合わせた電子書籍形式のアプリとして、いつでも取り出して閲覧できます。

   ┌──────────────┐   MCP    ┌──────────────┐  빌드 시 주입  ┌──────────────┐
   │  당신의 학습   │ ───────► │    Claude    │              │  안드로이드    │
   │  저장소        │ ◄─────── │              │              │  뷰어 (APK)   │
   │  (private)    │  기록     └──────────────┘              └──────────────┘
   └──────────────┘                                                ▲
          └─────────────────────────────────────────────────────────┘

このリポジトリにないもの

問題文も、問題番号も、解答コードもここにはありません。 すべてあなたのprivateリポジトリにのみあります。

多くのアルゴリズム学習プラットフォームは、問題と解答の公開・共有を利用規約で禁止しています。 そのためsweaConnectorは意図的に空の器です — ツール・規約・一般的なCSの概念説明だけを含み、 内容はビルド時にあなたのリポジトリから注入されます。fixtures/ のサンプル問題はすべて架空のものです。

構成

はじめに

git clone https://github.com/rleaderjoon/sweaConnector
cd sweaConnector
npm install
npm test                              # 13개 자체 검증 (MCP 핸드셰이크 포함)

# 1. 내 저장소가 규약에 맞는지 확인
node pipeline/extract.mjs --repo /path/to/my-study-repo --out content.json

# 2. 일정 설정 — 내 학습 저장소 루트에 .sweaconnector.json
echo '{"startDate":"2026-08-15","examDate":"2026-09-19"}' > /path/to/my-study-repo/.sweaconnector.json

# 3. Claude 에 붙이기
claude mcp add swea -- node ./mcp/index.mjs --repo /path/to/my-study-repo

# 4. 내 APK 굽기 — 콘텐츠 추출부터 서명까지 한 번에
bash pipeline/build-apk.sh /path/to/my-study-repo release

APKは app/reader/build/outputs/apk/release/ に出力されます。GitHub Actionsに任せる場合は .github/workflows/apk.yml を手動実行してください (公開リポジトリのためデモコンテンツで焼き込みます)。

スマートフォンにインストールする

1. APKを自分のprivateリポジトリのReleaseにアップロードする — gh release create v0.1.0 <apk> -R <owner>/<repo>

2. スマートフォンのブラウザでそのReleaseを開き、APKをダウンロードする (GitHubにログインしている必要があります)

3. "提供元不明のアプリ"のインストールをブラウザで一度許可する

公開リポジトリに自分のAPKをアップロードしないでください — APK内に問題と解答が含まれています。

画面

折りたたんだり開いたりしても読んでいた位置が維持されます (configChanges でアクティビティが再生成されません)。

MCPツール

schedule_status は計画書を読んでくれるツールではなく、計画がすでにずれている前提で修正してくれるツールです。 slackDays を先に見てください — 受験日までの余裕日数で、マイナスならペースを上げる必要があります。

要件

• Node 20+

• JDK 17+ · Android SDK (platform 35) — ローカルビルド時のみ。Actionsでビルドする場合は不要。

設計原則

• 読み取り専用ビューアー。 アプリでは編集しません。書き込みはClaude(MCP)を通じてリポジトリへ行われます。

• 実行時ネットワークなし。 コンテンツはビルド時にAPKへ焼き込まれます。タップしたときにパースするものがなければ即座に表示されます。

• 折りたたみ端末ファースト。 折りたたむと1ページ、開くと見開き。縦・横とも。

• 図解はベクター。 アルゴリズム図解は手書きのSVG → VectorDrawable。AI生成画像はそれらしく間違えます。

ライセンス

MIT (ツール・概念説明に限る)。あなたが注入する内容の権利・規約遵守はあなたの責任です。