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:

# 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:

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:

python generate_sample_data.py

4. Inicie o servidor MCP:

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:

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