mcpField
C
Chatbot MCP

Chatbot MCP

Local
github.com/AndersonHqdsAI & Agents0Updated 74w ago
Repository

About Chatbot MCP

Chatbot MCP is a Portuguese-language chatbot project for natural-language account top-ups and debits, with CPF validation. It combines a command-line client and REST/MCP server and uses GPT-4 to interpret requests.

Key features

  1. 01Natural-language processing with GPT-4
  2. 02CPF format and check-digit validation
  3. 03Account top-ups and debits
  4. 04Command-line interface
  5. 05REST API with MCP support

Use cases

  1. 01Top up an account using a CPF
  2. 02Debit a specified amount from an account
  3. 03Validate a CPF with or without punctuation

MCP support

The project includes an MCP server and client. Its REST/MCP server supports account operations initiated through natural-language requests.

#chatbot#mcp#natural-language-processing

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "chatbot": {
      "command": "npx",
      "args": [
        "-y",
        "ts-node"
      ]
    }
  }
}
Run commandnpx -y ts-node

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmts-node

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Chatbot MCP

Um chatbot inteligente que utiliza o Model Context Protocol (MCP) para processar requisições e realizar operações, com suporte a validação de CPF e operações de recarga.

🚀 Funcionalidades

  • Processamento de linguagem natural usando GPT-4
  • Validação robusta de CPF
  • Sistema de recarga com operações de adição e subtração
  • Interface via linha de comando
  • API REST com suporte a MCP

📋 Pré-requisitos

  • Node.js (versão 18 ou superior)
  • npm ou yarn
  • Chave de API do OpenAI

🔧 Instalação

  1. Clone o repositório:
git clone [url-do-repositorio]
cd chatbot-mcp
  1. Instale as dependências:
npm install
  1. Crie um arquivo .env na raiz do projeto com sua chave da OpenAI:
OPENAI_API_KEY=sua-chave-aqui

🚀 Como Executar

  1. Inicie o servidor:
npx ts-node server.ts
  1. Em outro terminal, inicie o cliente:
npx ts-node index.ts

💻 Uso

O chatbot suporta os seguintes comandos:

  • Realizar recarga: "Realizar uma recarga de R$50 para o CPF 123.456.789-09"
  • Realizar débito: "Realize um débito de x valor para o cpf y"
  • Lembrando que você pode escolher as palavras, trocar débito por "Tire x valor do cpf y" etc...
Exemplos de Uso
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

🛠️ Tecnologias Utilizadas

  • TypeScript
  • Express.js
  • OpenAI GPT-4
  • Model Context Protocol (MCP)
  • Zod para validação
  • CORS para segurança

📝 Estrutura do Projeto

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

🔒 Validação de CPF

O sistema inclui uma validação robusta de CPF que:

  • Aceita CPFs com ou sem formatação (123.456.789-09 ou 12345678909)
  • Verifica o tamanho correto (11 dígitos)
  • Valida os dígitos verificadores
  • Rejeita CPFs com todos os dígitos iguais

📄 Licença

Este projeto está sob a licença ISC.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.