Chalkieboard iCloud

초키보드 iCloud MCP サーバー · Chalkieboard iCloud MCP

英語。 小学校の教師向けiPadホワイトボードアプリChalkieboard用のローカル MCP サーバーです。 このアプリは、各教科をiCloud Drive内のフォルダーとして保存し、機械可読なstructure.jsonを備えています。このサーバーは、そのフォルダーを通じてClaude（または任意のMCPクライアント）に 8つのツールを提供します。教科、授業、ファイルの一覧表示、教材の追加（ファイル名に基づいて授業に自動配置）、テキストファイルの読み取り、 アプリが取り込む授業計画の追加、教科フォルダーの作成ができます。削除は行わず、アプリ独自のデータベースにも触れません。アプリはフォルダーから追記するだけなので、間違ったファイルを置いても授業データが壊れることはありません。ネットワーク通信もテレメトリーもありません（PRIVACY.md）。 依存関係はゼロで、Node 18+が必要です。サンプルフォルダーを使えば、アプリなしでも試せます。macOSとWindows（iCloud for Windows）に対応しています。

Mac上のAI（Claude Desktop・Claude Codeなど）が、iPadアプリのiCloud授業フォルダーを読み取り、教材を置き、単元・授業計画を追加できるようにします。 依存関係はゼロで、Node 18+だけで使えます。

できること

ツール	機能
list_subjects	教科（バインダー）の一覧 — フォルダー名・学年度・学期・単元・授業数・ファイル数、クラス一覧、フォルダー規則
list_lessons	1つの教科（またはすべて）の単元・授業と関連資料、待機中の不足ファイル
get_lesson	1つの授業 — 資料ファイルがフォルダーにあるかどうかも確認
list_files	教科フォルダー内のファイル（サブフォルダーを含む）— 種類・ファイル名の配置情報・クラス表示・アプリとの連携状況
add_material	教科フォルダーにpdf・pptx・htmlファイルを置く。unit・first（・last）・gradeを指定すると、学年_学期_単元_授業の接頭辞を付けてその授業に自動配置し、classを指定すると末尾に(クラス)を追加
read_file	教科フォルダー内のテキストファイルを読み取る
plan_lessons	割り当て表（lessons.chalkie.json）に単元・授業・資料の関連付けを追記 — アプリが次回の走査時に反映
create_subject	新しい教科フォルダー教科 (学年度-学期)と空の割り当て表を作成 — アプリが次回の走査時にバインダーを作成

リソース：chalkieboard://structure.json・chalkieboard://README.md・chalkieboard://<教科フォルダー>/lessons.chalkie.json。

削除するツールはありません。 削除はアプリ内でのみ行えます。このサーバーはアプリの保存データ（library.json）に触れません — フォルダーからアプリへの一方向の追記なので、ファイルを1つ間違って置いてもアプリのデータが壊れることはありません。

インストール

Claude Desktop — ワンクリック（推奨）

./tools/mcp/make_bundle.sh && open -a Claude tools/mcp/dist/chalkieboard.mcpb

.mcpbバンドルはClaude Desktopが内部にコピーし、自身のNodeで起動します — MacにNodeをインストールする必要も、リポジトリのパスに縛られることもありません。 サーバーを修正した場合は、バンドルを再作成して開き直してください（インストール画面から更新できます）。

Claude Code

claude mcp add --scope user chalkieboard -- node "/path/to/chalkieboard-icloud-mcp/chalkieboard-mcp.mjs"

Claude Desktop — 設定ファイルを使用（バンドルの代わり）

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "chalkieboard": {
      "command": "node",
      "args": ["/path/to/chalkieboard-icloud-mcp/chalkieboard-mcp.mjs"]
    }
  }
}

フォルダーは~/Library/Mobile Documents/iCloud~only1mui~ChalkieBoard/Documentsにあります。 別の場所（シミュレーターの-cloudrootフォルダーなど）を参照するには、環境変数CHALKIEBOARD_DIRを設定してください。

前提条件

• iPadアプリがサブスクリプション有効の状態でiCloudにログインしている必要があります。そうするとフォルダーとstructure.jsonが作成されます。
• このMacも同じiCloudアカウントを使用している必要があります。まだダウンロードされていないファイル（.icloud）は、一覧に表示されるだけです。

アプリなしで試す

sample/には、アプリが使用する形式そのままのサンプルフォルダー（教科2つ、割り当て表、ワークシート1つ）があります。拡張機能の設定にある「授業フォルダー」で選択するか、CHALKIEBOARD_DIRで指定してください。 審査担当者やほかの開発者が、iPadアプリなしでツールを試す際に使用できます。

テスト

node tools/mcp/selftest.mjs

一時フォルダーにアプリが使用する形式そのままのファイルを作成し、すべてのツール、パストラバーサルの拒否、上書きの拒否、割り当て表への追記の冪等性を検証します。実際のiCloudフォルダーには触れません。

ストアへの掲載

掲載先	掲載する人	準備するもの
Claude Desktop「拡張機能を探す」	Anthropicの審査（Googleフォームを提出）	ディレクトリ_提出_초안.md — アイコンと連絡先は準備済み。公開リポジトリ、サンプルフォルダー、プライバシーポリシーのページが残っています
公開MCPレジストリ	✅ 掲載済み — io.github.207studio/chalkieboard-icloud-mcp	公開リポジトリ https://github.com/chalkieboard/chalkieboard-icloud-mcpにタグv<バージョン>をプッシュすると、release.ymlがバンドル・リリース・公開（OIDC）を行います

アイコンにはアプリアイコンの512px版（icon.png）を使用し、バンドルmanifestのicon・iconsに含めています。

公開リポジトリはこのフォルダーのコピーです — export_public.shが~/chalkieboard-icloud-mcpにエクスポートし（public/のGitHub Actionsを含む）、 そこでタグv<バージョン>をプッシュすると、release.ymlが自己テスト → バンドル → リリースへの添付 → レジストリへの公開まで行います。正本は常にここ（tools/mcp）です。