Handset

io.github.handset-hq由 GitHub 帳號 handset-hq 發布v0.1.1更新於 Nov 3, 2026

A business phone system for AI agents: send texts, place calls, read transcripts, buy numbers.

已驗證STDIO僅桌面溝通與協作商業與電商

概覽

AI 產生的概覽

Handset 是為 AI 代理打造的企業電話系統，讓助理傳送簡訊、撥打電話、讀取通話紀錄並購買號碼。

可以做什麼
  • 向真實聯絡人傳送簡訊、撥打電話
  • 讀取通話轉錄文字與訊息歷史
  • 購買與管理電話號碼
  • 透過 Handset API 處理遞送、對話串接以及 STOP/HELP 退訂合規
  • 清單未列出個別工具，因此此處不描述具體操作
適用情境
適合助理需要在業務流程中透過簡訊或語音聯繫他人（例如通知、後續追蹤或客戶溝通）時使用；建議先以免費的模擬測試模式金鑰安全試用。
執行需求
以本機 stdio 程序執行 npm 套件 @handset/mcp，需要 Node.js。需在 HANDSET_API_KEY 提供 Handset API 金鑰；測試模式金鑰（hs_test_…）免費且為模擬環境。除非設定 HANDSET_ALLOW_LIVE=1，否則會拒絕正式金鑰。真實流量需要 Handset 帳號。
安裝前請注意
正式金鑰會讓代理以真實費用向真人傳簡訊與撥打電話，因此必須明確設定 HANDSET_ALLOW_LIVE。API 金鑰應留在伺服器端，不要進入瀏覽器程式碼。訊息與通話會經 Handset API 傳送給第三方，傳送可能產生費用並觸發 STOP/HELP 等合規處理。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Handset，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Handset UI

Texting inside your product, in an afternoon.

Open-source React components for embedded messaging, built on the Handset API. Distributed the shadcn way: the CLI copies the source into your repo, styled with your Tailwind tokens, yours to change.

bash
# 1. Point the shadcn CLI at the Handset registrynpx shadcn@latest registry add @handset=https://ui.handset.dev/r/{name}.json
# 2. Install a complete texting surface + the server proxy routenpx shadcn@latest add @handset/messaging @handset/next-routes

Set HANDSET_API_KEY in your env, wire resolveTenantId() in the generated route to your session, and render it:

tsx
import { HandsetProvider } from "@handset/react";import { Messaging } from "@/components/handset/messaging";
export default function MessagesPage() {  return (    <HandsetProvider>      <div className="h-[600px]">        <Messaging />      </div>    </HandsetProvider>  );}

What's in the registry

ItemWhat it is
@handset/messagingTwo-pane texting surface — inbox + thread, responsive to mobile
@handset/inboxConversation list: previews, relative times, STOP badges, infinite scroll
@handset/threadMessage history: delivery states, opt-out handling, wired composer
@handset/composerDraft box with live SMS segment counting and unicode detection
@handset/next-routesNext.js proxy route — your API key never reaches the browser

Architecture

Two layers, like shadcn-on-Radix:

  • @handset/react (npm, versioned) — headless hooks: useConversations, useThread, useComposer, plus segment math and a tiny client. Logic we maintain; bring your own UI if you prefer.
  • The registry (apps/www/registry) — the visual components, copied into your project as source.

Components never hold API keys. They call proxy routes in your backend (added by @handset/next-routes); your server holds the Handset key and your existing session auth decides which tenant each signed-in user sees. The Handset API handles the rest — numbers, delivery, threading, 10DLC compliance, STOP/HELP.

Development

bash
pnpm installpnpm --filter @handset/react build   # hooks packagepnpm dev                             # docs site + live demo at localhost:3000pnpm registry:build                  # compile registry.json → public/r/*.json

The docs site serves a mock Handset API (apps/www/app/api/handset) so the demo works with zero setup.

Requirements

  • React 18+ (components target React 19 / Tailwind v4 / shadcn CLI ≥ 3)
  • A Handset account for real traffic — the demo runs on mock data without one

Roadmap

See ROADMAP.md — shipped components, what's next (call summaries, MMS attachments, more framework proxies), and non-goals. Issues with real use cases move items up the list.

License

MIT © Handset HQ, Inc.

來源：README.md，提交 1cfd7b7

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分