关于 Typebot Mcp Server
这款 MCP 服务将 Typebot 的 REST API 封装为可通过自然语言调用的工具,适合在 Claude Desktop 或其他 MCP 客户端中管理 Typebot 工作区、对话结果和聊天会话。
主要功能
- 01创建、列出、获取、更新和删除 Typebot
- 02发布或取消发布 Typebot
- 03获取对话结果
- 04启动 Typebot 聊天会话
适用场景
- 01创建或修改工作区中的 Typebot
- 02更改 Typebot 的发布状态
- 03查看某个机器人的对话结果
- 04启动与 Typebot 的聊天会话
MCP 相关
服务通过 STDIO 运行,并向 Claude Desktop 及其他 MCP 客户端提供 Typebot REST API 操作工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
MCP-Typebot
一个小型 MCP 服务,可通过 STDIO 将 Typebot 的 REST API 作为 Claude Desktop 中可调用的工具提供。 你可以使用自然语言命令创建、列出、获取、更新、删除、发布/取消发布 Typebot,列出结果并开始聊天。
功能
-
createBot
在工作区中创建新的 Typebot。
必填:name
可选:workspaceId、description -
listBots
列出工作区中的所有 Typebot。
可选:workspaceId -
getBot
根据 ID 获取 Typebot。
必填:botId -
updateBot
修改现有 Typebot(例如重命名)。
必填:botId、typebot(包含要更改字段的对象)
可选:overwrite -
deleteBot
根据 ID 删除 Typebot。
必填:botId -
publishBot / unpublishBot
切换 Typebot 的发布状态。
必填:botId -
listResults
获取 Typebot 的对话结果。
必填:botId
可选:limit、cursor、timeFilter、timeZone -
startChat
使用 Typebot 开始新的聊天会话。
必填:botId
可选:chat.context
前置条件
- Node.js 18+
- 有效的 Typebot API 令牌和工作区 ID
- Claude Desktop 已连接到本地 MCP 服务
安装
git clone <repo-url>
cd mcp-typebot
npm install
npm run build
你也可以直接通过 npm 安装已发布的软件包:
npm install mcp-typebot
npm start
运行
npm start
这会通过 STDIO 启动 MCP 服务。Claude Desktop(或任何 MCP 客户端)会自动连接到该服务。
在 Claude Desktop 中使用
只需输入自然语言命令,例如:
用户:“帮我创建一个新的 typebot”
Claude:“好的——叫什么名字?”
用户:“MyDemoBot”
Claude(内部调用):@createBot {"name":"MyDemoBot"}
或者,明确调用:
@updateBot {"botId":"<your_bot_id>","typebot":{"name":"NewName"},"overwrite":true}
你也可以开始聊天:
@startChat {"botId":"<your_bot_id>"}
扩展
- 在
src/tools/bots.ts中实现新工具,并在src/index.ts中注册。 - 为每个工具定义 Zod 架构,以实现自动提示和验证。
许可证
配置 Claude Desktop
要将 Claude Desktop 连接到此 MCP 服务,请将以下内容添加到 Claude 配置文件中(例如 claude_desktop_config.json):
{
"mcpServers": {
"mcp-typebot": {
"command": "node",
"args": [
"path/to/project/dist/index.js"
],
"env": {
"TYPEBOT_TOKEN": "YOUR_TOKEN_HERE",
"TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID"
}
}
}
}
确保 command 和 args 指向本地构建的 index.js,并且 .env 中的值与 env 中的值一致。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。