Mcp 类型机器人
概览
什么是 MCP-typebot?
MCP-typebot 是一个创新项目,托管在 GitHub 上,由用户 osdeibi 开发。该代码库旨在促进使用 MCP(多通道协议)框架创建和管理聊天机器人。该项目旨在简化构建能够在各种消息平台上运行的机器人的过程,为用户提供一个多功能的工具,以增强沟通和自动化。
MCP-typebot 的特点
- 多通道支持:MCP-typebot 允许开发者创建能够与多个消息平台上的用户互动的机器人,确保更广泛的覆盖和更好的用户参与。
- 用户友好的界面:该项目在可用性方面进行了设计,使所有技能水平的开发者都能更轻松地创建和管理他们的聊天机器人。
- 可定制的模板:用户可以使用各种模板自定义他们的机器人,使其能够根据特定需求调整机器人的响应和功能。
- 开源:作为一个公共代码库,MCP-typebot 欢迎贡献,允许开发者合作并进一步增强该项目。
如何使用 MCP-typebot
-
克隆代码库:首先使用以下命令从 GitHub 克隆 MCP-typebot 代码库到本地机器:
git clone https://github.com/osdeibi/MCP-typebot.git
-
安装依赖:导航到项目目录并安装必要的依赖。这通常可以使用像 npm 或 yarn 这样的包管理器完成:
cd MCP-typebot npm install
-
配置你的机器人:修改配置文件以设置机器人的参数,包括 API 密钥、响应模板和通道设置。
-
运行你的机器人:一切设置完成后,可以使用以下命令启动你的机器人:
npm start
-
测试和部署:在将机器人部署到生产环境之前,先在开发环境中测试它。确保它在所有预期的消息平台上正确互动。
常见问题解答
MCP-typebot 使用了哪些编程语言?
MCP-typebot 主要使用 JavaScript,利用 Node.js 实现服务器端功能。
我可以为 MCP-typebot 项目贡献吗?
可以!作为一个开源项目,欢迎贡献。你可以分叉代码库,进行更改,并提交拉取请求以供审查。
MCP-typebot 有可用的文档吗?
有,详细的文档可以在代码库的 README 文件和其他解释各种功能和设置说明的 markdown 文件中找到。
我该如何报告问题或错误?
你可以通过导航到 MCP-typebot GitHub 代码库中的“问题”标签,提交一个新问题,并详细描述问题。
MCP-typebot 适合初学者吗?
绝对适合!MCP-typebot 旨在用户友好,使所有技能水平的开发者,包括初学者,都能轻松使用。
详情
MCP-Typebot
A small MCP server that exposes Typebot’s REST API as callable tools in Claude Desktop (via STDIO). You can create, list, get, update, delete, publish/unpublish Typebots, list results, and start chats—using natural-language commands.
Features
-
createBot
Create a new Typebot in your workspace.
Required:name
Optional:workspaceId
,description
-
listBots
List all Typebots in your workspace.
Optional:workspaceId
-
getBot
Fetch a Typebot by its ID.
Required:botId
-
updateBot
Patch an existing Typebot (e.g. rename).
Required:botId
,typebot
(object with fields to change)
Optional:overwrite
-
deleteBot
Delete a Typebot by its ID.
Required:botId
-
publishBot / unpublishBot
Toggle a Typebot’s published state.
Required:botId
-
listResults
Retrieve conversation results for a Typebot.
Required:botId
Optional:limit
,cursor
,timeFilter
,timeZone
-
startChat
Begin a new chat session with a Typebot.
Required:botId
Optional:chat.context
Prerequisites
- Node.js 18+
- A valid Typebot API token and workspace ID
- Claude Desktop connected to your local MCP server
Installation
git clone <repo-url>
cd mcp-typebot
npm install
npm run build
You can also install the published package directly via npm:
npm install mcp-typebot
npm start
Running
npm start
This starts the MCP server on STDIO. Claude Desktop (or any MCP client) will connect to it automatically.
Usage in Claude Desktop
Simply write natural commands like:
User: “Create me a new typebot”
Claude: “Sure—what name?”
User: “MyDemoBot”
Claude (internally invokes):@createBot {"name":"MyDemoBot"}
Or, explicitly:
@updateBot {"botId":"<your_bot_id>","typebot":{"name":"NewName"},"overwrite":true}
You can also start a chat:
@startChat {"botId":"<your_bot_id>"}
Extending
- Add new tools by implementing them in
src/tools/bots.ts
and registering them insrc/index.ts
. - Define a Zod schema for each tool to get automatic prompting and validation.
License
Configuring Claude Desktop
To connect Claude Desktop to this MCP server, add the following to your Claude configuration (e.g. 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"
}
}
}
}
Make sure the command
and args
point to your local built index.js
, and that your .env
values match those in env
.
Server配置
{
"mcpServers": {
"mcp-typebot": {
"command": "node",
"args": [
"path/to/project/dist/index.js"
],
"env": {
"TYPEBOT_TOKEN": "YOUR_TOKEN_HERE",
"TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID"
}
}
}
}