自然语言MCP-MSSQL客户端
使用模型上下文协议（MCP）的SQL数据库的自然语言接口。此客户端允许用户通过Claude AI使用简单的英语问题查询Microsoft SQL Server数据库。
特性
- 自然语言查询：用简单的英语询问有关数据库的问题
- MCP集成：使用FastMCP连接到MCP-MSSQL服务器
- 克劳德·艾：使用Anthropic的Claude API将自然语言翻译成SQL
- 交互模式：直接键入问题并获取数据库结果
- 示范模式：运行预定义的问题以展示功能
组件
- MCP-MSSQL服务器：通过MCP提供对MS SQL Server数据库的访问
- 自然语言客户端：使用Claude API将纯英文转换为SQL
- FastMCP框架：处理客户端和服务器之间的通信
先决条件
- Python 3.8+
- 系统上已安装SQL Server的ODBC驱动程序
- 无烟煤API键
- 必需的Python包（fastmcp、anthropic、Python-dotenv等）
项目结构
MCP-MSSQL-SERVER-WEBAPP/
├── src/
│ └── mssql/ # MSSQL MCP server implementation
│ ├── __init__.py
│ └── server.py # Main MCP server
├── interactive_client.py # Interactive natural language client
├── demo_nl_client.py # Demo client with predefined questions
├── .env # Environment configuration (not in git)
├── .env.example # Example environment configuration
└── requirements.txt # Project dependencies安装说明
- 克隆存储库:
git clone https://github.com/david-ruffin/MCP-MSSQL-SERVER-WEBAPP.git
cd MCP-MSSQL-SERVER-WEBAPP- 设置虚拟环境:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt- 配置环境:
复制 .env.example 向 .env 并填写您的数据库和API凭据：
MSSQL_SERVER=your_server
MSSQL_DATABASE=your_database
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DRIVER={ODBC Driver 17 for SQL Server}
ANTHROPIC_API_KEY=your_api_key运行客户端
交互模式
运行交互式客户端以提出自己的问题：
source venv/bin/activate
export ANTHROPIC_API_KEY=$(grep ANTHROPIC_API_KEY .env | cut -d= -f2)
python interactive_client.py在提示符处键入自然语言问题，客户端将把它们转换为SQL，执行它们并显示结果。
示范模式
运行演示以查看预定义的问题：
source venv/bin/activate
export ANTHROPIC_API_KEY=$(grep ANTHROPIC_API_KEY .env | cut -d= -f2)
python demo_nl_client.py演示将自动运行几个示例问题，显示自然语言到SQL的转换和结果。
示例问题
- “有多少种产品？”
- “列出来自加利福尼亚州的所有客户”
- “给我看看最贵的产品”
- “不同的产品类别是什么？”
- “2004年下了多少订单？”
ODBC驱动程序设置
此客户端需要用于SQL Server的Microsoft ODBC驱动程序。按照Microsoft官方指南进行安装：
许可证
MIT许可证
