@textbee/mcp

textbee.dev 用の MCP サーバーです。textbee.dev は、Android スマートフォンを SMS API に変えるオープンソースの SMS ゲートウェイです。Claude Desktop、Claude Code、Cursor、および任意の MCP クライアントに、自分の電話と自分の番号を使って SMS を送受信する機能を提供します。

3つのツール、メッセージごとのマークアップなし、セルフホストの textbee インスタンスで動作します。

セットアップ

textbee アカウントと、ペアリングした Android デバイス、および ダッシュボード から取得した API キーが必要です。キーはアカウントへの完全なアクセス権を持ちます。パスワードのように扱ってください。

Claude Code

claude mcp add textbee -s user -e TEXTBEE_API_KEY=your-key -- npx -y @textbee/mcp

Claude Desktop

claude_desktop_config.json に追加します (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "textbee": {
      "command": "npx",
      "args": ["-y", "@textbee/mcp"],
      "env": { "TEXTBEE_API_KEY": "your-key" }
    }
  }
}

Cursor

同じオブジェクトを ~/.cursor/mcp.json に置きます。

初回起動が遅い場合

npx は初回実行時にパッケージをダウンロードします。クライアントが待機中にタイムアウトする場合は、一度グローバルにインストールして、設定でバイナリを指定してください:

npm install -g @textbee/mcp

{ "mcpServers": { "textbee": { "command": "textbee-mcp", "env": { "TEXTBEE_API_KEY": "your-key" } } } }

Related MCP server: commune-mcp

ツール

send_sms

1人以上の受信者に SMS を送信します (E.164 形式、例: +15550100123)。送信元の電話は自動的に選択されます: デフォルトのデバイス、そうでない場合は最も新しいハートビートを持つ有効なデバイス。オプションで device_id、sim_subscription_id、scheduled_at を指定できます。アカウントが SMS キューを使用する場合、配信確認用の sms_batch_id を返します。

get_messages

アカウント上のすべてのデバイスからメッセージを読み取ります。デフォルトは受信メッセージで、新しい順に表示されます。direction (received、sent、all)、フリーテキストの search、sms_batch_id (送信の受信者ごとの配信ステータス)、device_ids、および from/to の時間範囲でフィルタリングできます。重複や欠落のないポーリングのためのカーソルページネーションをサポートしています。

list_devices

アカウント上の電話: ID、有効状態、デフォルトで送信するもの、最終チェックイン、メッセージ数。

セルフホストの textbee

サーバーを自分のインスタンスに向けます:

"env": {
  "TEXTBEE_API_KEY": "your-key",
  "TEXTBEE_BASE_URL": "https://sms.example.com"
}

/api/v1 サフィックスはオプションで、自動的に追加されます。https://example.com/textbee のようなサブパス展開も機能します。無効な URL はエラーとなり、静かにフォールバックすることはないため、タイプミスが公開 API にキーを送信することはありません。

環境変数

注意事項

• あなたのキーはマシン上に留まります: このサーバーは上記のベース URL の textbee API とのみ通信します。

• 送信は textbee プランの割り当てにカウントされ、プランのレート制限がサーバー側で適用されます。

• すべての診断情報は stderr に出力されます。stdout は MCP プロトコル用に予約されています。

ライブラリとしての使用

このパッケージは、別の MCP ホストに埋め込むためのツール定義もエクスポートします (ホストされたリモートエンドポイントがこれらを再利用する方法です):

import { createTextbeeMcpServer, staticCredentials, loadConfig } from '@textbee/mcp'

const server = createTextbeeMcpServer({
  credentials: staticCredentials(loadConfig(process.env)),
})

資格情報はツール呼び出しごとに解決されるため、マルチテナントホストはリクエストごとに異なるキーを注入できます。credentialsFromAuthInfoExtra を参照してください。

ライセンス

MIT。 textbee プロジェクトの一部です。