mcpField
T
TalkToPlanB

TalkToPlanB

本地服务
github.com/JMLEE850623开发工具021 周前更新
代码仓库

关于 TalkToPlanB

TalkToPlanB 是面向 AI 助手的 MCP 服务，可通过 TalkToPlanB 开发者 API 操作聊天。它支持列出房间、读取消息和发送消息，并遵循 API 密钥的权限范围。

主要功能

  1. 01查看账户信息和 API 密钥权限
  2. 02列出群聊与私聊房间
  3. 03读取房间近期消息
  4. 04按房间或电话号码发送消息

适用场景

  1. 01查看聊天房间中的近期消息
  2. 02向房间或电话号码发送消息

MCP 相关

它通过 stdio 将 TalkToPlanB 的账户、房间和消息操作作为 MCP 工具提供。可执行的操作受 API 密钥权限限制。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "talktoplanb": {
      "command": "npx",
      "args": [
        "-y",
        "talktoplanb-mcp"
      ],
      "env": {
        "TALKTOPLANB_API_KEY": "<TALKTOPLANB_API_KEY>"
      }
    }
  }
}
启动命令npx -y talktoplanb-mcp
需要配置的环境变量
TALKTOPLANB_API_KEY密钥Your TalkToPlanB API key (ttpb_...), created in the developer portal

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmtalktoplanb-mcp1.0.1

工具

4

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

TalkToPlanB MCP 服务

让 AI 助手（Claude Desktop，以及任何 Model Context Protocol 客户端）使用 TalkToPlanB——列出聊天室、读取消息并发送消息。

它封装了 TalkToPlanB 开发者 REST API，并通过 stdio 进行 MCP 通信。

工具

工具描述
whoami当前 API 密钥的账户信息（用户 ID、用户名、权限范围）。
list_rooms列出你的群聊和私信（返回聊天室 ID）。
read_messages读取聊天室中的最新消息（roomId、可选的 limit）。
send_message通过 roomId 或 toPhone 发送消息（以及 text）。

1. 获取 API 密钥

  1. 打开开发者门户：https://talktoplanb.duckdns.org/portal
  2. 注册 / 登录，创建密钥，并授予 messages:read 和 messages:send 权限范围。
  3. 复制密钥（格式类似 ttpb_xxxxxxxx...）。

2. 与 Claude Desktop 搭配使用

将以下内容添加到 Claude Desktop 配置文件中 （Windows 上为 %APPDATA%\Claude\claude_desktop_config.json， macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

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

重启 Claude Desktop，然后尝试：“列出我的 TalkToPlanB 聊天室”或 “向 +60123456789 发送一条 TalkToPlanB 消息，内容为 hello。”

环境变量
变量必填默认值
TALKTOPLANB_API_KEY✅—
TALKTOPLANB_BASE_URL❌https://talktoplanb.duckdns.org

3. 本地开发

cd mcp-server
npm install
npm run build      # compiles src → dist
TALKTOPLANB_API_KEY=ttpb_... npm start

4. 发布到 npm（这样每个人都可以使用 npx talktoplanb-mcp）

cd mcp-server
npm login
npm publish --access public

发布后，你可以将其列入 MCP 注册目录（mcp.so、Glama、Smithery）—— 请参阅 ../marketing/listing-checklist.md。

备注

  • 需要 Node.js 18+（使用内置的 fetch）。
  • stdout 承载 MCP 协议；所有日志都输出到 stderr。
  • 服务只会执行 API 密钥权限范围允许的操作。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。