AI导哈

汽车数据库虚拟代理

LLM-MCP是一个交互式虚拟代理，用于通过自然语言搜索汽车数据库，支持SQLite存储和自动生成虚构数据。

  • by s-v7
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 s-v7/LLM-MCP

使用说明

LLM-MCP — Agente Virtual Interativo para Busca de Automóveis

Talk to your car database — natural language meets data intelligence.
sv7analytics.com.br

关于该项目

LLM-MCP（大语言模型-多模态内容处理） 它是一个使用自然语言进行汽车搜索的交互式虚拟代理。 演示工具在 python 它提供了一个 虚拟代理 用于在终端直接进行汽车交互式搜索。该项目采用 客户端-服务器架构 基于 MCP协议（模型上下文协议），com（注：在中文语境中，“com”通常作为域名后缀直接保留，不进行翻译，表示这是一个通用顶级域名，常用于网站域名。） SQLite存储， 自动生成虚假数据 e uma（葡萄牙语，意为“和一个”） 自动化测试套件 以展示自然语言处理（NLP）与结构化数据库之间的智能集成。

目标

展示对……的掌握

  • 现代Python（3.12+）
  • 进程间通信（客户端 ↔ 服务器）
  • 数据建模与持久化
  • 良好的编码实践
  • 自动化测试和结构可读性

项目结构

LLM-MCP/
├── cars.db                # Banco SQLite com veículos fictícios
├── Makefile               # Comandos utilitários (tests, run, etc.)
├── pyproject.toml         # Metadados e dependências
├── requirements.txt       # Dependências do projeto
├── README.md              # Este arquivo
├── src/
│   └── cars_arq/
│       ├── client_c2s.py        # Cliente interativo (interface no terminal)
│       ├── server_c2s.py        # Servidor MCP que acessa o banco
│       ├── db_c2s.py            # Conexão e consultas SQLite
│       ├── data_fake_c2s.py     # Geração de dados falsos com Faker
│       ├── models_c2s.py        # Modelo de dados do automóvel
│       ├── protocol_mcp_c2s.py  # Implementação do protocolo MCP
│       ├── configs.py           # Configurações gerais do sistema
│       └── __init__.py
└── tests/
        ├── test_filters.py  # Testes de filtros e consultas
        └── test_rtp.py      # Testes do protocolo de comunicação

安装与执行

克隆仓库

创建一个虚拟环境（如果需要）

python3 -m venv nome_ambiente
source nome_ambiente/bin/activate

安装依赖项

pip install -r requirements.txt

生成虚假数据

python3 -m cars_arq.data_fake_c2s

启动服务器

python3 -m cars_arq.server_c2s

启动客户端

python3 -m cars_arq.client_c2s

自动化测试

pytest -v
|| Via Makefile
make test

Makefile（快捷方式）

主要命令可通过以下方式获取： make：

命令 功能说明
make setup Cria（葡萄牙语，意为“创造”） .venv更新 pip 并以可编辑模式安装包
make seed 生成/更新虚拟数据在 cars.db
make run-server MCP服务器启动中
make run-client 打开交互式命令行界面 (CLI)
make test 运行其测试套件（pytest -q）
make fmt 格式化/代码检查（可选——见下文说明）

Dica de fluxo: make setup && make seed && make run-server （终端编号）e make run-client （在另一个）

测试验证

  • 搜索过滤器和结果一致性
  • 通过MCP实现客户端与服务器之间的正确通信。
  • 模拟交互中期望的代理回应。

CLI 查询示例

  • 价格高达70,000（元/其他货币单位）
  • 2018年至2020年的混合动力轿车
  • 圣保罗的柴油SUV
  • 我想要2023年的HVR（可能是指某种设备、技术或服务的缩写，具体需根据上下文确定）
  • 电动皮卡，价格高达12万

所用技术

  • Python 3.12及以上版本
  • SQLite/SQLAlchemy
  • Faker（假数据..）
  • pytest
  • PrettyTable（在终端中格式化结果）
  • MCP协议（模型上下文协议）

作者

作者 [西拉斯·瓦斯康塞洛斯]
工程师： 全栈开发人员

相关 MCP