mcpField
C
Chatbot MCP

Chatbot MCP

本地服务
github.com/AndersonHqdsAI 与智能体074 周前更新

关于 Chatbot MCP

Chatbot MCP 是一个葡萄牙语聊天机器人项目,可通过自然语言处理账户充值和扣款,并验证 CPF。它结合命令行客户端与 REST/MCP 服务,使用 GPT-4 解析请求。

主要功能

  1. 01使用 GPT-4 处理自然语言
  2. 02验证 CPF 格式和校验位
  3. 03账户充值与扣款
  4. 04命令行界面
  5. 05支持 MCP 的 REST API

适用场景

  1. 01使用 CPF 为账户充值
  2. 02从账户扣除指定金额
  3. 03验证带或不带标点的 CPF

MCP 相关

项目包含 MCP 服务和客户端。其 REST/MCP 服务支持通过自然语言请求执行账户操作。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"chatbot": {
"command": "npx",
"args": [
"-y",
"ts-node"
]
}
}
}
启动命令npx -y ts-node

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmts-node

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

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
  1. 安装依赖:
npm install
  1. 在项目根目录中创建 .env 文件,并填入你的 OpenAI 密钥:
OPENAI_API_KEY=sua-chave-aqui

🚀 如何运行

  1. 启动服务:
npx ts-node server.ts
  1. 在另一个终端中启动客户端:
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

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。