Smarter Weather Developer Onboarding

@smarterweather/mcp-onboarding

Smarter Weather 開発者オンボーディング MCP サーバーへの stdio ブリッジです。Smarter Weather プラットフォームをエージェントファーストで利用する方法です。AI コーディングエージェントは、エディター内からプランやドキュメントを確認し、サインアップし、API キーを発行し、MCP クライアントを設定し、請求を管理できます。

Smarter Weather 向けのデフォルト設定を備えた、mcp-remote の薄いラッパーです。検出ツールとアカウントツールはサーバー側で実行されます。start_trial はローカルで処理されます。このパッケージは HTTPS 経由でキーを発行し、.env（モード 0600）に SMARTERWEATHER_API_KEY を書き込み、12 文字の key_prefix のみを返します。stdio ブリッジ経由では、ホスト側の create_api_key／rotate_api_key も .env に保存し、平文を除去します。パッケージをアップグレードした後は、MCP サーバーを再起動して新しいインターセプターを読み込んでください。

CLI（MCP ホストなし）

npx -y @smarterweather/mcp-onboarding@latest login   # human present (device grant)
npx -y @smarterweather/mcp-onboarding@latest trial   # no human (trial mint)

どちらも .env に書き込み、キーのプレフィックスのみを出力します。login は人間による承認が完了するまで処理をブロックします。バックグラウンドで実行するか、長いシェルタイムアウトを設定して実行し、出力された URL を伝えてください。単一の許可リスト対象オブジェクトを出力するには、--json を渡します。

クイックスタート（匿名）

アカウントもキーも認証も不要です。公開されている検出ツール（get_plans、get_documentation、sign_up）はすぐに使えます。

{
  "mcpServers": {
    "smarterweather-onboarding": {
      "command": "npx",
      "args": ["-y", "@smarterweather/mcp-onboarding"]
    }
  }
}

認証モード（アカウントツール）

SMARTERWEATHER_ONBOARDING_AUTH=required を設定すると、アカウントに紐づくツール（create_api_key、list_api_keys、rotate_api_key、revoke_api_key、configure_mcp、get_usage、get_billing_status、upgrade_plan、open_billing_portal）が利用可能になります。最初のリクエストで OAuth 2.1 + PKCE ブラウザーサインイン（Clerk）が開始され、トークンは ~/.mcp-auth/ にキャッシュされます。

本番環境の Clerk では動的クライアント登録は無効になっています。ブリッジは事前登録された公開 PKCE OAuth クライアント（パッケージに client_id が組み込まれています）を使用し、mcp-remote のループバックコールバックを http://localhost:3334/oauth/callback に固定して、Clerk アプリのリダイレクト URI と一致させます。クライアントシークレットは不要で、同梱もされていません。

{
  "mcpServers": {
    "smarterweather-onboarding": {
      "command": "npx",
      "args": ["-y", "@smarterweather/mcp-onboarding"],
      "env": {
        "SMARTERWEATHER_ONBOARDING_AUTH": "required"
      }
    }
  }
}

認証時にはポート 3334 が空いていることを確認してください。mcp-remote がランダムなポートにフォールバックすると、Clerk にリダイレクトを拒否されます。

設定

環境変数	デフォルト	目的
SMARTERWEATHER_ONBOARDING_MCP_URL	https://mcp.developers.smarterweather.com	接続先エンドポイントの上書き（開発／ステージング）。位置引数の URL を指定した場合は、どちらよりも優先されます。
SMARTERWEATHER_ONBOARDING_AUTH	(未設定)	required → OAuth チャレンジとアカウントに紐づくツールを有効にします。
SMARTERWEATHER_ONBOARDING_OAUTH_CLIENT_ID	PQcxOLVZg5kxzhoC	事前登録された Clerk OAuth の client_id を上書きします（ステージング／別アプリ用）。
SMARTERWEATHER_ENV_FILE	(未設定)	ローカルの start_trial／CLI／プロキシ保存先の絶対パスです。未設定の場合、ブリッジは最初の MCP file:// ルート（/ と $HOME は除外）、次に cwd/.env を使用します。CLI サブコマンドにはルートがないため、この変数またはガード対象外の cwd が必要です。
SMARTERWEATHER_API_KEY	(未設定)	すでに設定されている場合、start_trial／trial／login／作成時の保存処理は何も行わず（already_configured）、キーを発行しません。
SMARTERWEATHER_API_BASE_URL	https://api.smarterweather.com	トライアル／ログイン用の key-api オリジンを上書きします（開発／ステージング）。

追加の CLI 引数（--debug、--transport http-only、--header X:y、…）は、そのまま mcp-remote に渡されます。コールバックポートまたは --static-oauth-client-info をすでに渡している場合、ブリッジはそれらを重複して追加しません。

--version はブリッジのバージョンと同梱された mcp-remote のバージョンを出力して終了します。

天気データをお探しですか？

このパッケージはプラットフォームのオンボーディングを行います。天気データ自体は @smarterweather/mcp-weather（mcp.smarterweather.com でホスト）から提供されます。configure_mcp を使えば簡単に設定できます。

ライセンス

MIT