local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides database functionality for storing and retrieving data about cars, enabling querying of the vehicle information stored in an SQLite database through the MCP protocol.
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
- 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.
- 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.
- Navegue até a pasta
- 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.
- Acesse a pasta
- 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.
- Com o banco de dados preenchido, vá até a pasta
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.
This server cannot be installed
A client-server system using Model Context Protocol that allows users to query a SQLite database of fictional car data.