企业微信应用号-发送语音消息

Instructions

Implementation Reference

• mcp_notify/wework.py:148-152 (handler)

  The tool handler function that sends a voice message via WeChat Work app. It accepts a voice URL and optional user target, then delegates to wework_send_media with msgtype='voice'.

  def wework_app_send_voice(
      url: str = Field(description="语音URL"),
      touser: str = FIELD_TO_USER,
  ):
      return wework_send_media(touser, url, "voice")

• mcp_notify/wework.py:164-197 (helper)

  The shared helper function that downloads media from a URL, uploads it to WeChat Work to get a media_id, then sends it as a message to users. Used by wework_app_send_voice with msgtype='voice'.

  def wework_send_media(touser, url: str, msgtype=None):
      if msgtype:
          pass
      elif '.jpg' in url.lower() or '.jpeg' in url.lower() or '.png' in url.lower():
          msgtype = 'image'
      elif '.mp4' in url.lower():
          msgtype = 'video'
      elif '.arm' in url.lower():
          msgtype = 'voice'
      else:
          msgtype = 'file'
      res = requests.get(url, timeout=120)
      res.raise_for_status()
      file = io.BytesIO(res.content)
      mine = res.headers.get("content-type") or "application/octet-stream"
      res = requests.post(
          f"{WEWORK_BASE_URL}/cgi-bin/media/upload",
          params={"type": msgtype, "access_token": get_access_token()},
          files={"media": ("filename", file, mine)},
          timeout=120,
      )
      media = res.json() or {}
      if not (media_id := media.get("media_id")):
          return media
      res = requests.post(
          f"{WEWORK_BASE_URL}/cgi-bin/message/send?access_token={get_access_token()}",
          json={
              "touser": touser or WEWORK_APP_TOUSER,
              "agentid": WEWORK_APP_AGENTID,
              "msgtype": msgtype,
              msgtype: {"media_id": media_id},
          },
      )
      return res.json()

• mcp_notify/wework.py:148-152 (schema)

  Input schema for the tool: url (string, voice file URL) and touser (string, target user IDs, defaults to env variable).

  def wework_app_send_voice(
      url: str = Field(description="语音URL"),
      touser: str = FIELD_TO_USER,
  ):
      return wework_send_media(touser, url, "voice")

• mcp_notify/wework.py:144-147 (registration)

  The @mcp.tool() decorator that registers wework_app_send_voice as an MCP tool with title and description.

  @mcp.tool(
      title="企业微信应用号-发送语音消息",
      description="通过企业微信应用号发送发送语音消息",
  )

• mcp_notify/wework.py:21-23 (registration)

  The add_tools function is called from __init__.py to register all WeChat Work tools including wework_app_send_voice.

  def add_tools(mcp: FastMCP, logger=None):
  
      @mcp.tool(