SMSGO MCP Server

需要 Python 3.10+。開啟終端機執行： Requires Python 3.10+. Run in terminal:

複製Copypip3 install "mcp[cli]" httpx

下載後建議放在 ~/mcp/smsgo_server.py： We recommend saving it to ~/mcp/smsgo_server.py:

複製Copymkdir -p ~/mcp
curl -o ~/mcp/smsgo_server.py https://www.smsgo.com.tw/mcp/smsgo_server.py

開啟 Claude Desktop → 設定 → Developer → Edit Config，將以下內容加入 claude_desktop_config.json，並填入您的帳號密碼： Open Claude Desktop → Settings → Developer → Edit Config, then add the following to claude_desktop_config.json and fill in your credentials:

複製{
  "mcpServers": {
    "smsgo": {
      "command": "python3",
      "args": ["/Users/你的帳號/mcp/smsgo_server.py"],
      "env": {
        "SMSGO_USERNAME": "你的SMSGO帳號",
        "SMSGO_PASSWORD": "你的密碼或API Key"
      }
    }
  }
}

Copy{
  "mcpServers": {
    "smsgo": {
      "command": "python3",
      "args": ["/Users/your_username/mcp/smsgo_server.py"],
      "env": {
        "SMSGO_USERNAME": "your_smsgo_username",
        "SMSGO_PASSWORD": "your_password_or_api_key"
      }
    }
  }
}

完全關閉並重新開啟 Claude Desktop。左下角工具列應出現 smsgo 伺服器圖示，代表連線成功。 Fully quit and reopen Claude Desktop. The smsgo server icon should appear in the bottom-left toolbar, confirming a successful connection.

Recipient replies
        │
        ▼
  SMSGO platform
        │  HTTP GET  srcaddr · dstaddr · smbody · timestamp · msgid
        ▼
  Public URL  (trycloudflare.com tunnel  OR  your own domain:port)
        │
        ▼
  smsgo_server.py  local HTTP server  :8765/mo_receive
        │  buffers up to 200 messages in memory
        ▼
  Claude reads via  get_received_mo()

安裝 cloudflared 後，MCP Server 會自動建立免費的公開隧道，無需設定 DNS 或防火牆。 Install cloudflared and the MCP server will automatically create a free public tunnel — no DNS or firewall configuration needed.

複製Copy# macOS
brew install cloudflare/cloudflare/cloudflared

# Linux
curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 \
     -o cloudflared && chmod +x cloudflared

在 MCP 設定中加入以下環境變數，即可在啟動時自動開啟隧道並向 SMSGO 登錄： Add these env vars to auto-start the tunnel and register it with SMSGO on launch:

複製Copy"env": {
  "SMSGO_USERNAME":    "your_username",
  "SMSGO_PASSWORD":    "your_password",
  "SMSGO_MO_ENABLED":  "true",
  "SMSGO_MO_REGISTER": "true"
}

若您有固定 IP 或反向代理（nginx、Caddy 等），設定 SMSGO_MO_PUBLIC_URL 即可略過 cloudflared。 If you have a static IP or reverse proxy (nginx, Caddy…), set SMSGO_MO_PUBLIC_URL to skip cloudflared.

複製Copy"env": {
  "SMSGO_USERNAME":       "your_username",
  "SMSGO_PASSWORD":       "your_password",
  "SMSGO_MO_ENABLED":     "true",
  "SMSGO_MO_PORT":        "8765",
  "SMSGO_MO_PUBLIC_URL":  "https://mo.example.com",
  "SMSGO_MO_REGISTER":    "true"
}

SMSGO 將呼叫：https://mo.example.com/mo_receive?srcaddr=…&smbody=… SMSGO will call: https://mo.example.com/mo_receive?srcaddr=…&smbody=…