Content
# MCP Server Demo - ClienteDB
Este é um exemplo de servidor MCP que demonstra a integração com SQLite para gerenciamento de clientes.
## Funcionalidades
O servidor oferece as seguintes ferramentas:
1. `contar_clientes()`: Retorna o número total de clientes cadastrados
2. `buscar_cliente_por_nome(nome)`: Busca clientes pelo nome (busca parcial)
3. `buscar_clientes_por_bairro(bairro)`: Busca todos os clientes de um determinado bairro
## Como usar
1. Crie e ative o ambiente virtual:
```bash
# Criar ambiente virtual
python3 -m venv .venv
# Ativar ambiente virtual
# No Windows:
.venv\Scripts\activate
# No macOS/Linux:
source .venv/bin/activate
```
2. Instale as dependências:
```bash
pip install -r requirements.txt # instalar no ambiente virtual
python3.12 -m pip install -r requirements.txt --break-system-packages # Instalar máquina física
```
3. Gere os dados de exemplo:
```bash
python generate_sample_data.py
```
4. Inicie o servidor MCP:
```bash
mcp dev server.py # para usar mcp inspector
mcp install server.py --name "ClientesMCP" # instala o mcp no claude desktop
python mcp_server.py # para usar pelo protocolo sse
```
Para desativar o ambiente virtual quando terminar:
```bash
deactivate
```
## Estrutura do Banco de Dados
A tabela `clientes` contém os seguintes campos:
- id (INTEGER, PRIMARY KEY)
- nome (TEXT)
- email (TEXT)
- telefone (TEXT)
- bairro (TEXT)
- endereco (TEXT)
## Bairros Disponíveis
Os dados de exemplo incluem clientes nos seguintes bairros:
- Centro
- Jardim América
- Vila Nova
- Bela Vista
MCP Store