MCP ExplorerExplorer

Mcp Car

@Gabriel-Maxsyon 12 days ago
1 MIT
FreeCommunity
AI Systems
Projeto que envolve a criação de um sistema de busca de veículos utilizando o protocolo MCP, um protocolo de comunicação estruturada para troca de dados entre cliente e servidor.

Overview

What is Mcp Car

MCP-Car is a project that involves creating a vehicle search system using the Model Context Protocol (MCP), which is a structured communication protocol for data exchange between client and server.

Use cases

Use cases for MCP-Car include searching for vehicles in a dealership database, managing vehicle inventories, and providing data for automotive applications.

How to use

To use MCP-Car, set up a virtual environment, create and configure a SQLite database, populate it with fictional car data, and then run the client to query the database.

Key features

Key features of MCP-Car include a structured communication protocol (MCP), a SQLite database for data storage, and a client-server architecture allowing for efficient data querying.

Where to use

MCP-Car can be used in fields such as automotive sales, vehicle inventory management, and any application requiring structured vehicle data retrieval.

Content

Projeto MCP

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.

Estrutura de pastas

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

Como rodar o projeto

  1. Criar e configurar o ambiente virtual

    • Para garantir que todas as dependências do projeto sejam instaladas corretamente, é recomendado criar um ambiente virtual.

    • Na raiz do seu projeto, execute o seguinte comando para criar um ambiente virtual:

      python -m venv venv

      Em seguida:

      .\venv\Scripts\activate

      Então para baixar as dependências:

      pip install -r requirements.txt

    • Isso instalará todas as bibliotecas que o projeto necessita para funcionar corretamente.

Agora você pode seguir com o restante da configuração do projeto, já com o ambiente virtual pronto para uso.

  1. Criar o banco de dados

    • Navegue até a pasta app.
    • 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.
  2. Preencher o banco de dados com dados fictícios

    • Acesse a pasta utils.
    • 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.
  3. Executar o cliente e consultar os dados

    • Com o banco de dados preenchido, vá até a pasta client.
    • 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.

Exemplo de uso

Ao rodar o cliente (client.py), você será solicitado a informar critérios de busca, como:

  • Marca
  • Modelo
  • Ano
  • Cor
  • Preço máximo

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.

Você pode interromper a busca digitando “sair” a qualquer momento.


Contribuições

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.

Tools

No tools

Comments