Chatbot MCP

Chatbot MCP

Model Context Protocol（MCP）を使用してリクエストを処理し、操作を実行するインテリジェントなチャットボットです。CPF の検証とチャージ操作に対応しています。

🚀 機能

• GPT-4 を使用した自然言語処理
• 堅牢な CPF 検証
• 追加と減算の操作に対応したチャージシステム
• コマンドラインインターフェース
• MCP に対応した REST API

📋 前提条件

• Node.js（バージョン 18 以降）
• npm または yarn
• OpenAI の API キー

🔧 インストール

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

git clone [url-do-repositorio]
cd chatbot-mcp

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

npm install

3. OpenAI のキーを記載した .env ファイルをプロジェクトのルートに作成します：

OPENAI_API_KEY=sua-chave-aqui

🚀 実行方法

1. サーバーを起動します：

npx ts-node server.ts

2. 別のターミナルでクライアントを起動します：

npx ts-node index.ts

💻 使用方法

チャットボットでは、次のコマンドを使用できます：

• チャージする：「CPF 123.456.789-09 に 50 レアルをチャージして」
• 引き落とす：「CPF y から x 金額を引き落として」
• 表現は自由に選べます。「引き落とす」を「CPF y から x 金額を引いて」などに変更することもできます。

使用例

Query: Realizar uma recarga de R$50 para o CPF 123.456.789-09
Resposta: O saldo do colaborador com CPF 123.456.789-09 é de R$ 50

🛠️ 使用技術

• TypeScript
• Express.js
• OpenAI GPT-4
• Model Context Protocol（MCP）
• 検証用の Zod
• セキュリティ用の CORS

📝 プロジェクト構成

chatbot-mcp/
├── src/
│   ├── index.ts          # Cliente MCP
│   ├── server.ts         # Servidor Express
│   ├── server-base.ts    # Configuração do servidor MCP
│   └── in-memory-accounts.ts # Gerenciamento de contas
├── package.json
├── tsconfig.json
└── README.md

🔒 CPF 検証

このシステムには、次の機能を備えた堅牢な CPF 検証が含まれています。

• 書式設定の有無を問わず CPF を受け付けます（123.456.789-09 または 12345678909）
• 桁数が正しいこと（11 桁）を確認します
• 検証用数字を検証します
• すべての桁が同じ CPF を拒否します

📄 ライセンス

このプロジェクトは ISC ライセンスの下で公開されています。