Mcp Typebot

概覽

什麼是 MCP-typebot？

MCP-typebot 是一個創新的項目，托管在 GitHub 上，由用戶 osdeibi 開發。這個倉庫旨在促進使用 MCP（多通道協議）框架創建和管理聊天機器人的過程。該項目的目標是簡化構建可以在各種消息平台上運行的機器人的過程，為用戶提供一個多功能的工具，以增強通信和自動化。

MCP-typebot 的特點

多通道支持：MCP-typebot 允許開發者創建可以在多個消息平台上與用戶互動的機器人，確保更廣泛的覆蓋範圍和更好的用戶參與。
友好的用戶界面：該項目以可用性為設計重點，使各種技能水平的開發者更容易創建和管理他們的聊天機器人。
可自定義模板：用戶可以使用各種模板自定義他們的機器人，使其能夠根據特定需求調整機器人的響應和功能。
開源：作為一個公共倉庫，MCP-typebot 歡迎貢獻，允許開發者合作並進一步增強該項目。

如何使用 MCP-typebot

克隆倉庫：首先使用以下命令將 MCP-typebot 倉庫從 GitHub 克隆到本地機器：
```
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 in src/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.

{ "mcpServers": { "mcp-typebot": { "command": "node", "args": [ "path/to/project/dist/index.js" ], "env": { "TYPEBOT_TOKEN": "YOUR_TOKEN_HERE", "TYPEBOT_WORKSPACE_ID": "YOUR_WORKSPACE_ID" } } } }

概覽