MCP Car

Local 2025-08-31 23:43:30 0

A client-server system using Model Context Protocol that allows users to query a SQLite database of fictional car data.


x000D Este é um projeto finalizado que utiliza o protocolo MCP (Model Context Protocol) para comunicação entre cliente e servidor. O projeto inclui a criação de um banco de dados SQLite e a implementação de um cliente que consulta esse banco.x000D x000D

Estrutura de pastas_x000D_

x000D ? mcp-car x000D │-- ? app x000D │ ├── server.py # Arquivo do servidor MCP x000D │ ├── database.py # Script responsável pela criaçãodo banco de dados x000D │-- ? client x000D │ ├── client.py # Código principal do cliente onde ocorre interação x000D │-- ? utils x000D │ ├── create_cars.py # Gera dados fictícios para o banco x000D │-- README.md # Documentação do projeto_x000D_ x000D

Como rodar o projeto_x000D_

x000D 1. Criar e configurar o ambiente virtualx000D x000D - Para garantir que todas as dependências do projeto sejam instaladas corretamente, é recomendado criar um ambiente virtual. x000D - Na raiz do seu projeto, execute o seguinte comando para criar um ambiente virtual:x000D x000D python -m venv venvx000D x000D Em seguida:x000D x000D .venvScriptsactivatex000D x000D Então para baixar as dependências:x000D x000D pip install -r requirements.txtx000D - Isso instalará todas as bibliotecas que o projeto necessita para funcionar corretamente.x000D x000D Agora você pode seguir com o restante da configuração do projeto, já com o ambiente virtual pronto para uso.x000D x000D x000D 2. Criar o banco de dadosx000D - Navegue até a pasta app.x000D - Abra o arquivo database.py e execute-o para criar o banco de dados no formato SQLite dentro da sua pasta "data". Este script criará a estrutura necessária para armazenar os dados dos carros.x000D x000D 3. Preencher o banco de dados com dados fictíciosx000D - Acesse a pasta utils.x000D - Abra o arquivo create_cars.py e execute-o para popular o banco de dados com 100 registros de carros fictícios. Esse passo é necessário para ter dados no banco antes de rodar o sistema.x000D x000D 4. Executar o cliente e consultar os dadosx000D - Com o banco de dados preenchido, vá até a pasta client.x000D - Execute o arquivo client.py para interagir com o sistema. O agente permitirá que você insira filtros (como marca, modelo, ano, etc.) para procurar carros no banco de dados.x000D x000D

Exemplo de uso_x000D_

x000D Ao rodar o cliente (client.py), você será solicitado a informar critérios de busca, como:x000D x000D - Marca_x000D_ - Modelo_x000D_ - Ano_x000D_ - Cor_x000D_ - Preço máximo_x000D_ x000D O cliente enviará a consulta para o servidor, que realizará a busca no banco de dados e retornará os carros que atendem aos critérios fornecidos.x000D x000D Você pode interromper a busca digitando "sair" a qualquer momento.x000D x000D ---x000D x000D

Contribuições_x000D_

x000D Sinta-se à vontade para explorar e modificar o projeto conforme necessário. Caso tenha dúvidas ou queira sugerir melhorias, envie um pull request ou entre em contato.