Bark推送通知

Instructions

Implementation Reference

• mcp_notify/other.py:105-140 (handler)

  The actual handler function for the 'bark_send_notify' tool. It sends a push notification via the Bark API (https://api.day.app) using the provided parameters (body, title, subtitle, device_key, url, icon, level, volume). Falls back to env vars for device_key and base URL.

  def bark_send_notify(
      body: str = Field(description="推送内容"),
      title: str = Field("", description="推送标题"),
      subtitle: str = Field("", description="推送副标题"),
      device_key: str = Field("", description="设备key，默认从环境变量获取"),
      url: str = Field("", description="点击推送时，跳转的URL ，支持URL Scheme 和 Universal Link"),
      icon: str = Field("", description="自定义图标URL"),
      level: str = Field(
          "active",
          description="推送中断级别。"
                      "critical: 重要警告, 在静音模式下也会响铃"
                      "active：默认值，系统会立即亮屏显示通知"
                      "timeSensitive：时效性通知，可在专注状态下显示通知。"
                      "passive：仅将通知添加到通知列表，不会亮屏提醒。",
      ),
      volume: int = Field(5, description="重要警告的通知音量(0-10)，默认为5"),
  ):
      """
      https://bark.day.app/#/tutorial
      """
      if not device_key:
          device_key = os.getenv("BARK_DEVICE_KEY", "")
      base = os.getenv("BARK_BASE_URL") or "https://api.day.app"
      res = requests.post(
          f"{base}/{device_key}",
          json={
              "body": body,
              "title": title,
              "subtitle": subtitle,
              "url": url,
              "icon": icon,
              "level": level,
              "volume": volume,
          },
      )
      return res.json()

• mcp_notify/other.py:101-104 (registration)

  The @mcp.tool decorator registering 'bark_send_notify' with FastMCP, providing its title and description.

  @mcp.tool(
      title="Bark推送通知",
      description="通过Bark推送通知",
  )

• mcp_notify/other.py:105-121 (schema)

  The function signature defines the input schema using Pydantic Field descriptors for all parameters (body, title, subtitle, device_key, url, icon, level, volume).

  def bark_send_notify(
      body: str = Field(description="推送内容"),
      title: str = Field("", description="推送标题"),
      subtitle: str = Field("", description="推送副标题"),
      device_key: str = Field("", description="设备key，默认从环境变量获取"),
      url: str = Field("", description="点击推送时，跳转的URL ，支持URL Scheme 和 Universal Link"),
      icon: str = Field("", description="自定义图标URL"),
      level: str = Field(
          "active",
          description="推送中断级别。"
                      "critical: 重要警告, 在静音模式下也会响铃"
                      "active：默认值，系统会立即亮屏显示通知"
                      "timeSensitive：时效性通知，可在专注状态下显示通知。"
                      "passive：仅将通知添加到通知列表，不会亮屏提醒。",
      ),
      volume: int = Field(5, description="重要警告的通知音量(0-10)，默认为5"),
  ):