MCP Typebot

🚀 MCP-Typebot

MCP-Typebot是一個小型的MCP服務器，它將Typebot的REST API以可調用工具的形式集成到Claude Desktop中（通過標準輸入輸出）。你可以使用自然語言命令來創建、列出、獲取、更新、刪除、發佈/取消發佈Typebot，列出對話結果以及啟動聊天。

🚀 快速開始

要使用MCP-Typebot，你需要完成以下幾個步驟：

1. 確保滿足前置要求。
2. 安裝項目。
3. 啟動MCP服務器。
4. 配置Claude Desktop以連接到MCP服務器。

✨ 主要特性

• createBot
  在你的工作區中創建一個新的Typebot。
  必需參數：name
  可選參數：workspaceId、description

• listBots
  列出你工作區中的所有Typebot。
  可選參數：workspaceId

• getBot
  通過Typebot的ID獲取它的信息。
  必需參數：botId

• updateBot
  對現有的Typebot進行部分更新（例如重命名）。
  必需參數：botId、typebot（包含要更改字段的對象）
  可選參數：overwrite

• deleteBot
  通過Typebot的ID刪除它。
  必需參數：botId

• publishBot / unpublishBot
  切換Typebot的發佈狀態。
  必需參數：botId

• listResults
  獲取Typebot的對話結果。
  必需參數：botId
  可選參數：limit、cursor、timeFilter、timeZone

• startChat
  與Typebot開始一個新的聊天會話。
  必需參數：botId
  可選參數：chat.context

📦 安裝指南

通過克隆倉庫安裝

git clone <repo-url>
cd mcp-typebot
npm install
npm run build

通過npm直接安裝已發佈的包

npm install mcp-typebot
npm start

💻 使用示例

在Claude Desktop中使用

你可以直接使用自然語言命令，例如：

用戶：“幫我創建一個新的Typebot”
Claude：“當然可以，它叫什麼名字？”
用戶：“MyDemoBot”
Claude（內部調用）：

@createBot {"name":"MyDemoBot"}

或者，你也可以顯式地使用命令：

@updateBot {"botId":"<your_bot_id>","typebot":{"name":"NewName"},"overwrite":true}

你還可以啟動一個聊天：

@startChat {"botId":"<your_bot_id>"}

啟動服務

npm start

這將在標準輸入輸出上啟動MCP服務器，Claude Desktop（或任何MCP客戶端）將自動連接到它。

📚 詳細文檔

擴展功能

• 你可以通過在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中的值匹配。

🔧 技術細節

前置要求

1. Node.js 18+
2. 有效的Typebot API令牌和工作區ID
3. Claude Desktop已連接到你的本地MCP服務器