prepboard

prepboard

prepboard は、Calaf の採用ワークスペースサーバー向けの小さな転送クライアントです。シードワークフローをカバーしており、シード文書形式の読み取り、形式に照らしたシードの検証、ワークスペースへのシードのインポート、ワークスペース一覧の取得ができます。1 つのバイナリで、コマンドラインインターフェースと stdio MCP サーバーの両方を提供します。

ラベル付きコアサブセット — 38 個中 4 個のツール。 元の Calaf アカウントサーバーには 38 個のツールが記載されていますが、パラメーター表が公開されているのはそのうち 4 個だけです。prepboard はその 4 個だけを実装し、スキーマを捏造する代わりに、残りの 34 個は省略しています。省略されているツールは次のとおりです：export_seed、get_profile_schema、get_firm_profile、submit_firm_profile、log_touchpoint、update_contact、add_task、get_contacts、get_firms、log_firm_work、get_firm_work、remove_firm_work、get_applications、schedule_interview、add_application、update_application、get_tasks、complete_task、snooze_task、add_firm、update_firm、add_office、add_note、get_notes、update_note、create_workspace、rename_workspace、archive_workspace、add_template、get_templates、update_template、add_prep_question、get_prep、draft_prep_answer。

Calaf との通信方法

呼び出しは、JSON-RPC の tools/call POST として上流の MCP エンドポイントに転送されます。この通信形式は公開仕様から再構成したものとして記載されており、上流の result 値がそのまま返されます。

• 公開シードエンドポイント：https://calaf.ai/api/mcp — 認証不要です。 seed-format / get_seed_format と validate-seed / validate_seed を提供します。
• アカウントエンドポイント：https://calaf.ai/api/mcp-account — CALAF_ACCESS_TOKEN 環境変数のトークンを使った Authorization: Bearer <token> が必要です。import-seed / import_seed と workspaces / list_workspaces を提供します。トークンが設定されていない場合、これらのコマンドは CALAF_ACCESS_TOKEN の名前を含むエラーで失敗し、結果を捏造することはありません。

エンドポイントの上書きには、公開エンドポイント用の CALAF_MCP_URL と、アカウントエンドポイント用の CALAF_ACCOUNT_MCP_URL を使用します。

インストール

npx @reneturcios/prepboard seed-format

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/prepboard

コンテナはデフォルトで MCP サーバーとして起動します（下記参照）。CLI として使用するには、CLI 引数を渡します。コンテナ内でアカウントコマンドを実行するには、-e CALAF_ACCESS_TOKEN=... が必要です。

CLI

prepboard seed-format
prepboard validate-seed '<seed-json-or-string>'
prepboard import-seed my-workspace '<seed-json-or-string>' --parts orgs,templates,prep,contacts
prepboard workspaces

prepboard --version

<seed> 引数は、オブジェクトとして解析できる場合は JSON 値として扱われ、それ以外の場合はプレーンテキストのシードとして扱われます。Calaf のシード形式では、文字列形式とオブジェクト形式の両方が受け付けられます。コマンドは上流の結果を JSON として出力します。終了コード：成功時は 0、呼び出しの失敗時（トークン不足や上流エラーを含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

1 つのバイナリで両方のインターフェースを提供します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/prepboard mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "prepboard": {
      "command": "npx",
      "args": ["-y", "@reneturcios/prepboard", "mcp"],
      "env": {
        "CALAF_ACCESS_TOKEN": "<your Calaf access token>"
      }
    }
  }
}

トークンが必要なのは import_seed と list_workspaces のみです。get_seed_format と validate_seed は、何も設定しなくても使用できます。

ツール

ツール	入力	エンドポイント	返される内容
get_seed_format	（なし）	公開	シード文書形式。
validate_seed	seed（文字列またはオブジェクト、必須）	公開	そのシードの検証結果。
import_seed	workspace（必須）、seed（文字列またはオブジェクト、必須）、parts（文字列配列、任意：orgs / templates / prep / contacts）	アカウント	インポート結果。
list_workspaces	（なし）	アカウント	呼び出し元のワークスペース。

開発

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

ライセンス

MIT — LICENSE を参照してください。