Smarter Weather Developer Onboarding

@smarterweather/mcp-onboarding

连接到 Smarter Weather developer onboarding MCP server 的标准输入输出桥接程序——这是以 Agent 为先的 Smarter Weather 平台接入方式。你的 AI 编码 Agent 可以探索套餐和文档、为你注册、创建 API 密钥、配置 MCP 客户端并管理账单，所有操作都能在编辑器中完成。

这是一个基于 mcp-remote 并采用 Smarter Weather 默认配置的轻量封装。发现和账户工具在服务端运行。start_trial 在本地处理：此包通过 HTTPS 创建密钥，将 SMARTERWEATHER_API_KEY 写入 .env（权限模式为 0600），并且仅返回 12 个字符的 key_prefix。通过标准输入输出桥接程序调用时，托管的 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 会一直阻塞，直到用户批准——请在后台运行，或使用较长的 shell 超时时间，并转发打印出的 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	覆盖试用／登录密钥 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