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 分