mcp-server-python-demo
3.2
If you are the rightful owner of mcp-server-python-demo and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Este é um exemplo de servidor MCP que demonstra a integração com SQLite para gerenciamento de clientes.
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:
contar_clientes(): Retorna o número total de clientes cadastradosbuscar_cliente_por_nome(nome): Busca clientes pelo nome (busca parcial)buscar_clientes_por_bairro(bairro): Busca todos os clientes de um determinado bairro
Como usar
- 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
- 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
- Gere os dados de exemplo:
python generate_sample_data.py
- 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
