README - MCP Host Client Server SSE by hanshan006

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	年龄
email	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 协议开源，详情请参见文件。