What is Mcp Host Client Server Sse

MCP_Host_Client_Server_SSE is a natural language SQL database query system based on the Model Context Protocol (MCP). It allows users to convert natural language queries into SQL queries and demonstrates a server-client architecture integrated with OpenAI for intelligent querying.

Use cases

Use cases include querying user information, displaying orders for specific users, calculating total spending per user, and retrieving user information based on order amounts.

How to use

To use MCP_Host_Client_Server_SSE, clone the repository, install the required dependencies, configure your OpenAI API key, create a sample database, and then run the MCP server and client applications.

Key features

Key features include a server-client architecture based on MCP, natural language to SQL query support, real-time communication using Server-Sent Events (SSE), SQLite database integration, OpenAI/DeepSeek interface integration, a complete logging system, and support for asynchronous operations.

Where to use

MCP_Host_Client_Server_SSE can be used in various fields such as data analysis, business intelligence, customer relationship management, and any application that requires natural language processing for database querying.

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密钥

安装步骤

1. 克隆仓库：

git clone https://github.com/HanShan006/MCP_Host_Client_Server_SSE.git
cd MCP_Host_Client_Server_SSE

2. 安装依赖：

pip install openai mcp-framework starlette uvicorn

3. 配置API密钥：
   创建config.ini文件并添加以下内容：

[secrets]
API_KEY=your_api_key_here

4. 创建示例数据库：

python create_database.py

运行服务

1. 启动MCP服务器：

python mcp_server.py

2. 运行客户端应用：

python mcp_host.py

数据库结构

users表

orders表

示例查询

系统支持多种自然语言查询，例如：

1. “查询所有用户的信息”
2. “显示张三的所有订单”
3. “统计每个用户的消费总额”
4. “查询订单金额超过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 文件。