Mcp タイプボット

作成者：

osdeibi•Jun 26, 2025

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ファイルおよびさまざまな機能や設定手順を説明する追加のマークダウンファイルにあります。

問題やバグを報告するにはどうすればよいですか？

MCP-typebotのGitHubリポジトリの「Issues」タブに移動し、問題の詳細な説明を含む新しい問題を提出することで報告できます。

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"
      }
    }
  }
}

プロジェクト情報

著者

osdeibi