关于 Chatbot MCP
Chatbot MCP 是一个葡萄牙语聊天机器人项目,可通过自然语言处理账户充值和扣款,并验证 CPF。它结合命令行客户端与 REST/MCP 服务,使用 GPT-4 解析请求。
主要功能
- 01使用 GPT-4 处理自然语言
- 02验证 CPF 格式和校验位
- 03账户充值与扣款
- 04命令行界面
- 05支持 MCP 的 REST API
适用场景
- 01使用 CPF 为账户充值
- 02从账户扣除指定金额
- 03验证带或不带标点的 CPF
MCP 相关
项目包含 MCP 服务和客户端。其 REST/MCP 服务支持通过自然语言请求执行账户操作。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Chatbot MCP
一个使用 Model Context Protocol (MCP) 处理请求并执行操作的智能聊天机器人,支持 CPF 验证和充值操作。
🚀 功能
- 使用 GPT-4 处理自然语言
- 强大的 CPF 验证功能
- 支持充值和扣款操作的系统
- 命令行界面
- 支持 MCP 的 REST API
📋 前置条件
- Node.js(18 或更高版本)
- npm 或 yarn
- OpenAI API 密钥
🔧 安装
- 克隆仓库:
git clone [url-do-repositorio]
cd chatbot-mcp
- 安装依赖:
npm install
- 在项目根目录中创建
.env文件,并填入你的 OpenAI 密钥:
OPENAI_API_KEY=sua-chave-aqui
🚀 如何运行
- 启动服务:
npx ts-node server.ts
- 在另一个终端中启动客户端:
npx ts-node index.ts
💻 使用
聊天机器人支持以下命令:
- 进行充值:"为 CPF 123.456.789-09 充值 R$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 许可证。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。