Talktoplanb Mcp

io.github.JMLEE850623由 GitHub 帳號 JMLEE850623 發布v1.0.1更新於 Oct 25, 2026

MCP server for TalkToPlanB: list rooms, read & send messages (WhatsApp alternative).

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

針對 TalkToPlanB 的本機 MCP 伺服器，讓助理透過 TalkToPlanB API 列出聊天室、讀取近期訊息並傳送訊息。

可以做什麼
查詢目前 API 金鑰對應的帳號資訊（使用者 ID、使用者名稱、權限範圍）。列出群組聊天與私訊及其聊天室 ID。讀取某個聊天室的近期訊息，可限制筆數。依聊天室 ID 或直接依手機號碼傳送訊息。
適用情境
當你希望助理處理 TalkToPlanB 對話時適用：檢視某聊天室的近期訊息、尋找聊天室 ID，或在桌面 MCP 用戶端中向聊天室或手機號碼傳送訊息。
執行需求
透過 npx（npm 套件 talktoplanb-mcp）以 stdio 在本機執行，需要 Node.js 18 以上版本。需在環境變數 TALKTOPLANB_API_KEY 提供於開發者入口網站建立的 TalkToPlanB API 金鑰，並授予 messages:read 與 messages:send 權限。選用環境變數 TALKTOPLANB_BASE_URL 可覆寫預設 API 位址。需要能連線至 TalkToPlanB 服務的網路。
安裝前請注意
API 金鑰是寫入用戶端設定的機密，持有者可在其權限範圍內操作。此伺服器能向聊天室與手機號碼傳送訊息，助理可能因此聯絡真實使用者。訊息內容會傳送至 TalkToPlanB 服務。預設位址並非常見網域，使用金鑰前請確認信任該服務。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

TalkToPlanB MCP Server

Let AI assistants (Claude Desktop, and any Model Context Protocol client) use TalkToPlanB — list chat rooms, read messages, and send messages.

It wraps the TalkToPlanB developer REST API and talks MCP over stdio.

Tools

ToolDescription
whoamiAccount info for the current API key (user id, username, scopes).
list_roomsList your group chats and direct messages (returns room ids).
read_messagesRead recent messages in a room (roomId, optional limit).
send_messageSend a message by roomId or toPhone (plus text).

1. Get an API key

  1. Open the developer portal: https://talktoplanb.duckdns.org/portal
  2. Register / log in, create a key, and grant the messages:read and messages:send scopes.
  3. Copy the key (looks like ttpb_xxxxxxxx...).

2. Use it with Claude Desktop

Add this to your Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

json
{  "mcpServers": {    "talktoplanb": {      "command": "npx",      "args": ["-y", "talktoplanb-mcp"],      "env": {        "TALKTOPLANB_API_KEY": "ttpb_your_key_here"      }    }  }}

Restart Claude Desktop, then try: “List my TalkToPlanB rooms” or “Send a TalkToPlanB message to +60123456789 saying hello.”

Environment variables

VariableRequiredDefault
TALKTOPLANB_API_KEY✅—
TALKTOPLANB_BASE_URL❌https://talktoplanb.duckdns.org

3. Local development

bash
cd mcp-servernpm installnpm run build      # compiles src → distTALKTOPLANB_API_KEY=ttpb_... npm start

4. Publish to npm (so npx talktoplanb-mcp works for everyone)

bash
cd mcp-servernpm loginnpm publish --access public

After publishing, you can list it on MCP registries (mcp.so, Glama, Smithery) — see ../marketing/listing-checklist.md.

Notes

  • Requires Node.js 18+ (uses the built-in fetch).
  • stdout carries the MCP protocol; all logs go to stderr.
  • The server only does what your API key is allowed to do (its scopes).

來源：README.md，提交 cbbb68d

工具

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

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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