Natural Language MCP-MSSQL Client

自然语言 MCP-MSSQL 客户端

使用模型上下文协议（MCP）为 SQL 数据库提供自然语言接口。通过 Claude AI，用户可以使用通俗的英语问题查询 Microsoft SQL Server 数据库。

功能

• 自然语言查询：使用通俗的英语询问数据库相关问题
• MCP 集成：使用 FastMCP 连接 MCP-MSSQL 服务
• Claude AI：使用 Anthropic 的 Claude API 将自然语言转换为 SQL
• 交互模式：直接输入问题并获取数据库结果
• 演示模式：运行预设问题以展示功能

组件

1. MCP-MSSQL 服务：通过 MCP 提供对 MS SQL Server 数据库的访问
2. 自然语言客户端：使用 Claude API 将通俗的英语转换为 SQL
3. FastMCP 框架：处理客户端与服务端之间的通信

先决条件

• Python 3.8+
• 系统中已安装 SQL Server 的 ODBC 驱动程序
• Anthropic 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

设置说明

1. 克隆仓库：

   git clone https://github.com/david-ruffin/MCP-MSSQL-SERVER-WEBAPP.git
   cd MCP-MSSQL-SERVER-WEBAPP
   

2. 设置虚拟环境：

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   

3. 配置环境： 将 .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 驱动程序设置

此客户端需要 Microsoft SQL Server 的 ODBC 驱动程序。请按照 Microsoft 官方指南进行安装：

• Windows
• macOS/Linux

许可证

MIT 许可证