Chatterbox MCP Server

🚀 Chatterbox MCP サーバー

Chatterbox MCP サーバーは、「モデルコンテキストプロトコル（MCP）」をベースにした最先端の実装で、個人利用を念頭に設計されています。このサーバーは、アプリケーションと強力な AI モデルの間の架け橋として機能し、WhatsApp などのツールとの通信をシームレスに統合します。チャットボットの構築、タスクの自動化、AI の実験など、あらゆる用途に最適なソリューションです！

✨ 主な機能

• 動的リソース管理：MCP フレームワークを使って、リソースの登録と管理を簡単に行えます。
• WhatsApp 統合：WhatsApp のメッセージの送受信や、組み込みツールを使った連絡先情報の検索が可能です。
• 環境駆動型設定：柔軟なデプロイを通じて、キーと環境変数を安全に管理および設定できます。
• Stdio 伝送：標準入出力を通じた通信により、簡単かつポータブルな運用が可能です。
• Docker 対応：コンテナ化環境でのサーバーのデプロイが容易です。

🔧 技術詳細

このプロジェクトでは、以下の技術を利用して、強力で拡張性の高いソリューションを提供しています。

• TypeScript：型安全と最新の JavaScript 機能を保証します。
• Node.js：高速で効率的なランタイム環境を提供します。
• モデルコンテキストプロトコル SDK：サーバーの核心機能を支えます。
• Zod：ツールとリソースの入力パターンを検証します。
• Express：HTTP サーバーの作成とルーティングを簡素化します。
• Docker：一貫した環境でのコンテナ化デプロイを実現します。
• Nodemon：自動再起動によるリアルタイム開発を促進します。

📚 ドキュメント

プロジェクト構造

以下は、プロジェクト構造の概要です。

src/ src/server.ts # メインサーバーのエントリーポイント model/ src/model/resources.ts # リソース登録ロジック src/model/tools.ts # ツール登録ロジック（例：WhatsApp ツール） types/ src/types/types.ts # プロジェクトの型定義 secrets/ # 安全な環境変数ファイル .vscode/ # VS Code の設定ファイル package.json # プロジェクトのメタデータとスクリプト tsconfig.json # TypeScript の設定 dockerfile # コンテナ化用の Docker 設定 README.md # このドキュメントです！

🚀 クイックスタート

1. リポジトリをクローンする：

   git clone https://github.com/your-repo/chatterbox_mcp_server.git
   cd chatterbox_mcp_server
   

2. 依存関係をインストールする：

   npm install
   

3. 開発モードで実行する：

   npm run dev
   

4. ビルドして起動する：

   npm run build
   npm start
   

5. Docker で実行する：

   npm run docker:local
   

💻 使用例

基本的な使用法

WhatsApp メッセージの取得

特定の電話番号の未読メッセージを取得するには、以下のようにします。

{
  "phoneNumber": "+1234567890",
  "numberOfRecords": "5"
}

WhatsApp メッセージの送信

特定の電話番号にメッセージを送信するには、以下のようにします。

{
  "phoneNumber": "+1234567890",
  "message": "Chatterbox MCP サーバーからの挨拶です！"
}

WhatsApp ユーザーの検索

名前で WhatsApp ユーザーを検索し、その WhatsApp ID を取得するには、以下のようにします。

{
  "contactName": "John Doe"
}

🤖 Chatterbox MCP サーバーの魅力

このプロジェクトは単なるサーバーではありません。これは革新的なアイデアを実現するための試験場です。開発者が AI 統合を探索するために、また愛好家がワークフローを自動化するために、Chatterbox MCP サーバーはあなたのアイデアを現実にする原動力となります。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。自由に使用、修正、共有してください！

💬 フィードバックと貢献

ご意見をいただけると幸いです！問題を報告したり、プルリクエストを送信したりして、このプロジェクトに貢献してください。

Happy coding！🎉