MCP Host Client Server SSE
基于MCP（Model Context Protocol）协议实现的自然语言SQL数据库查询系统，支持通过大语言模型将自然语言转换为SQL查询。本项目展示了如何使用MCP协议构建服务器-客户端架构，并集成OpenAI实现智能查询功能。
功能特点
- 🚀 基于MCP协议的服务器-客户端架构
- 📝 支持自然语言转SQL查询
- 🔄 使用SSE（Server-Sent Events）实现实时通信
- 📊 SQLite数据库集成
- 🤖 OpenAI/DeepSeek接口集成
- 📝 完整的日志记录系统
- ⚡ 异步操作支持
系统架构
graph TD
A[用户] -->|自然语言问题| B[MCP Host]
B -->|API调用| C[OpenAI]
C -->|SQL查询| B
B -->|MCP请求| D[MCP Server]
D -->|查询| E[SQLite DB]
E -->|结果| D
D -->|SSE响应| B
B -->|自然语言解释| A快速开始
前置要求
- Python 3.8+
- pip包管理器
- OpenAI API密钥
安装步骤
- 克隆仓库：
git clone https://github.com/HanShan006/MCP_Host_Client_Server_SSE.git
cd MCP_Host_Client_Server_SSE- 安装依赖：
pip install openai mcp-framework starlette uvicorn- 配置API密钥：
创建config.ini文件并添加以下内容：
[secrets]
API_KEY=your_api_key_here- 创建示例数据库：
python create_database.py运行服务
- 启动MCP服务器：
python mcp_server.py- 运行客户端应用：
python mcp_host.py数据库结构
users表
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER | 用户ID（主键） |
| name | TEXT | 用户名 |
| age | INTEGER | 年龄 |
| TEXT | 邮箱地址 |
orders表
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER | 订单ID（主键） |
| user_id | INTEGER | 用户ID（外键） |
| product_name | TEXT | 商品名称 |
| price | REAL | 价格 |
| order_date | TEXT | 订单日期 |
示例查询
系统支持多种自然语言查询，例如：
- "查询所有用户的信息"
- "显示张三的所有订单"
- "统计每个用户的消费总额"
- "查询订单金额超过5000元的用户信息"
项目结构
MCP_Host_Client_Server_SSE/
├── mcp_server.py # MCP服务器实现
├── mcp_client.py # MCP客户端实现
├── mcp_host.py # 主机程序（集成OpenAI）
├── create_database.py # 数据库初始化脚本
├── database.db # SQLite数据库文件
├── config.ini # 配置文件
└── README.md # 项目文档技术栈
- Python 3.8+
- MCP Framework
- SQLite
- OpenAI API
- Starlette
- Server-Sent Events (SSE)
- Async/Await
版本历史
v1.0.0 (2025-05-07)
- ✨ 初始版本发布
- 🎉 实现基础MCP服务器功能
- 🎉 完成客户端通信模块
- 🎉 集成OpenAI自然语言处理
- 🎉 添加SQLite数据库支持
- 📝 完善项目文档
贡献者
- 程序员寒山 (@HanShan006)
开源协议
本项目采用 MIT 协议开源，详情请参见 LICENSE 文件。
