MCP车数据查询系统
使用模型上下文协议的客户端-服务器系统,允许用户查询虚构的汽车数据的SQLite数据库。
服务介绍
MCP 项目
这是一个已完成的项目,使用 MCP(Model Context Protocol)协议进行客户端和服务器之间的通信。该项目包括创建一个 SQLite 数据库以及实现一个查询该数据库的客户端。
文件夹结构
📁 mcp-car
│-- 📂 app
│ ├── server.py # MCP 服务器文件
│ ├── database.py # 负责创建数据库的脚本
│-- 📂 client
│ ├── client.py # 客户端主要代码,用于交互
│-- 📂 utils
│ ├── create_cars.py # 生成虚拟数据到数据库中
│-- README.md # 项目文档
如何运行项目
-
创建并配置虚拟环境
-
为了确保项目的全部依赖项正确安装,建议创建一个虚拟环境。
-
在您的项目根目录下,执行以下命令来创建一个虚拟环境:
python -m venv venv然后:
.\venv\Scripts\activate接下来安装依赖项:
pip install -r requirements.txt -
这将安装项目正常运行所需的所有库。
-
现在您可以继续完成项目的其余设置,已经准备好使用的虚拟环境了。
-
创建数据库
- 导航到
app文件夹。 - 打开
database.py文件并执行它,以在您的 "data" 文件夹内创建 SQLite 格式的数据库。此脚本将创建存储汽车数据所需的结构。
- 导航到
-
用虚拟数据填充数据库
- 访问
utils文件夹。 - 打开
create_cars.py文件并执行它,以向数据库中添加 100 条虚拟汽车记录。这一步是必要的,以便在运行系统前数据库中有数据。
- 访问
-
执行客户端并查询数据
- 当数据库已填充好数据后,转到
client文件夹。 - 执行
client.py文件与系统互动。代理允许您输入过滤器(如品牌、型号、年份等)来搜索数据库中的汽车。
- 当数据库已填充好数据后,转到
使用示例
当运行客户端 (client.py) 时,系统会要求您提供搜索条件,例如:
- 品牌
- 型号
- 年份
- 颜色
- 最高价格
客户端将把查询发送给服务器,服务器将在数据库中进行搜索,并返回满足所提供条件的汽车信息。
您可以通过键入**"退出"**随时中断搜索。
贡献
请随意探索和按需修改项目。如果您有任何疑问或想要提出改进建议,请发送拉取请求或联系我们。